Merge pull request #9812 from microsoft/main

Update date. (#9811)

.github/ISSUE_TEMPLATE/config.yml

@@ -0,0 +1,5 @@
+blank_issues_enabled: true
+contact_links:
+  - name: Discussion or question
+    url: https://github.com/microsoft/vscode-cpptools/discussions/new
+    about: Please use our Discussions board to start a discussion or to ask a question.

.github/ISSUE_TEMPLATE/debugger.yml

@@ -0,0 +1,78 @@
+name: Bug Report - Debugger
+description: Create a bug report for debugging such as call stack, breakpoints, watch window, launching or attaching to a debuggee.
+body:
+- type: markdown
+  attributes:
+    value: |
+      ### Is there an existing issue for this?
+      Please search our [existing issues](https://github.com/microsoft/vscode-cpptools/issues) to see if an issue already exists for the bug you encountered.
+
+      Please also review our [documentation](https://code.visualstudio.com/docs/languages/cpp) and [FAQs](https://code.visualstudio.com/docs/cpp/faq-cpp).
+- type: textarea
+  attributes:
+    label: Environment
+    description: |
+      Please provide the information for the following:
+        - OS and version
+        - VS Code version
+        - C/C++ extension version
+        - OS and version of remote machine (if applicable)
+        - GDB / LLDB version
+    value: |
+        - OS and version:
+        - VS Code:
+        - C/C++ extension:
+        - OS and version of remote machine (if applicable):
+        - GDB / LLDB version:
+  validations:
+    required: true
+- type: textarea
+  attributes:
+    label: Bug Summary and Steps to Reproduce
+    description: |
+      Please describe the debugging issue or debugger feature that is not working as expected.
+
+      Include clear steps on how to reproduce the issue.
+    value: |
+      Bug Summary:
+
+
+      Steps to reproduce:
+      1. In this environment...
+      2. With this config...
+      3. Do '...'
+      4. See error...
+  validations:
+    required: true
+- type: textarea
+  attributes:
+    label: Debugger Configurations
+    description: Please provide the debugger configurations from the **tasks.json** and **launch.json** files.
+    render: shell
+  validations:
+    required: true
+- type: textarea
+  attributes:
+    label: Debugger Logs
+    description: |
+      If applicable, please include [logging for the debugger adapter](https://code.visualstudio.com/docs/cpp/enable-logging-cpp#_enable-logging-for-the-debug-adapter) by adding `"logging": { "engineLogging": true, "trace": true, "traceResponse": true }` in the **launch.json** file.
+
+      Include logs or error messages from the Debug Console or Output windows.
+    render: shell
+  validations:
+    required: true
+- type: textarea
+  attributes:
+    label: Other Extensions
+    description: If applicable, please list other extensions installed and if the issue persists after disabling other extensions.
+  validations:
+    required: false
+- type: textarea
+  attributes:
+    label: Additional Information
+    description: |
+      Optionally provide other information that will give us more context about the issue you are encountering, such as a code sample, screenshots, or screen recording of the issue.
+
+      Tip: You can attach images or log files by clicking this area to highlight it and then dragging files in.
+  validations:
+    required: false

.github/ISSUE_TEMPLATE/feature-request.yml

@@ -0,0 +1,15 @@
+name: Feature Request
+description: Suggest an idea for the C/C++ extension.
+body:
+- type: markdown
+  attributes:
+    value: |
+      ### Is there an existing request for this feature?
+      Prior to creating a new feature request, please review our [existing feature requests](https://github.com/microsoft/vscode-cpptools/issues?q=is%3Aopen+is%3Aissue+label%3A%22Feature+Request%22) to avoid duplicates.
+- type: textarea
+  attributes:
+    label: Feature Request
+    description: |
+      Describe the feature you'd like.
+  validations:
+    required: true

.github/ISSUE_TEMPLATE/general-extension.yml

@@ -0,0 +1,59 @@
+name: Bug Report - General Extension
+description: Create a bug report for downloading, installing, or building the extension.
+body:
+- type: markdown
+  attributes:
+    value: |
+      ### Is there an existing issue for this?
+      Please search our [existing issues](https://github.com/microsoft/vscode-cpptools/issues) to see if an issue already exists for the bug you encountered.
+
+      Please also review our [documentation](https://code.visualstudio.com/docs/languages/cpp) and [FAQs](https://code.visualstudio.com/docs/cpp/faq-cpp).
+- type: textarea
+  attributes:
+    label: Environment
+    description: |
+      Please provide the information for the following:
+        - OS and version
+        - VS Code version
+        - C/C++ extension version
+        - OS and version of remote machine (if applicable)
+    value: |
+        - OS and version:
+        - VS Code:
+        - C/C++ extension:
+        - OS and version of remote machine (if applicable):
+  validations:
+    required: true
+- type: textarea
+  attributes:
+    label: Bug Summary and Steps to Reproduce
+    description: |
+      Please give a description of the issue you are encountering and what you expected to happen.
+
+      Include clear steps on how to reproduce the issue.
+    value: |
+      Bug Summary:
+
+
+      Steps to reproduce:
+      1. In this environment...
+      2. With this config...
+      3. Do '...'
+      4. See error...
+  validations:
+    required: true
+- type: textarea
+  attributes:
+    label: Other Extensions
+    description: If applicable, please list other extensions installed and if the issue persists after disabling other extensions.
+  validations:
+    required: false
+- type: textarea
+  attributes:
+    label: Additional Information
+    description: |
+      Optionally provide other information that will give us more context about the issue you are encountering.
+
+      Tip: You can attach images or log files by clicking this area to highlight it and then dragging files in.
+  validations:
+    required: false

.github/ISSUE_TEMPLATE/language-service.yml

@@ -0,0 +1,86 @@
+name: Bug Report - Language Service
+description: Create a bug report for IntelliSense, autocomplete, code editing, code navigation, etc.
+body:
+- type: markdown
+  attributes:
+    value: |
+      ### Is there an existing issue for this?
+      Please search our [existing issues](https://github.com/microsoft/vscode-cpptools/issues) to see if an issue already exists for the bug you encountered.
+
+      Please also review our [documentation](https://code.visualstudio.com/docs/languages/cpp) and [FAQs](https://code.visualstudio.com/docs/cpp/faq-cpp).
+- type: textarea
+  attributes:
+    label: Environment
+    description: |
+      Please provide the information for the following:
+        - OS and Version
+        - VS Code Version
+        - C/C++ Extension Version
+        - Other extensions you installed (and if the issue persists after disabling them)
+        - If using SSH remote, specify OS of remote machine
+        - A clear and concise description of what the bug is, including information about the workspace (i.e. is the workspace a single project or multiple projects, size of the project, etc).
+    value: |
+        - OS and Version:
+        - VS Code Version:
+        - C/C++ Extension Version:
+        - Other extensions you installed (and if the issue persists after disabling them):  
+        - If using SSH remote, specify OS of remote machine:  
+        - A clear and concise description of what the bug is, including information about the workspace (i.e. is the workspace a single project or multiple projects, size of the project, etc).
+  validations:
+    required: true
+- type: textarea
+  attributes:
+    label: Bug Summary and Steps to Reproduce
+    description: |
+      Please describe the language service issue or language service feature that is not working as expected.
+
+      Include clear steps on how to reproduce the issue.
+    value: |
+      Bug Summary:
+
+
+      Steps to reproduce:
+      1. Go to '...'
+      2. Click on '....'
+      3. Scroll down to '....'
+      4. See error
+  validations:
+    required: true
+- type: textarea
+  attributes:
+    label: Expected behavior
+    description: A clear and concise description of what you expected to happen.
+  validations:
+    required: false
+- type: textarea
+  attributes:
+    label: Code sample and Logs
+    description: |
+      Please provide code sample, your c_cpp_properties.json and logs:
+        - Code sample
+        - Configurations in `c_cpp_properties.json`
+        - Logs from running `C/C++: Log Diagnostics` from the VS Code command palette
+        - Logs from [the language server logging](https://code.visualstudio.com/docs/cpp/enable-logging-cpp#_enable-logging-for-the-language-server)
+    render: shell
+  validations:
+    required: true
+- type: textarea
+  attributes:
+    label: Screenshots
+    description: If applicable, add screenshots to help explain your problem.
+  validations:
+    required: false
+- type: textarea
+  attributes:
+    label: Additional context
+    description: |
+      Providing call stacks:
+      For bugs like crashes, deadlocks, infinite loops, etc. that we are not able to repro and for which the call stack may be useful, please attach a debugger and/or create a dmp and provide the call stacks. Windows binaries have symbols available in VS Code by setting your "symbolSearchPath" to "https://msdl.microsoft.com/download/symbols".
+
+      Instructions for attaching debugger to language service process:
+      https://github.com/microsoft/vscode-cpptools/wiki/Attaching-debugger-to-cpptools-or-cpptools%E2%80%90srv.
+
+      Performance analysis:
+      For a performance issue see instructions at https://github.com/microsoft/vscode-cpptools/wiki/Troubleshooting-Performance-Issues.
+  validations:
+    required: false

.github/actions/.gitignore

@@ -0,0 +1,3 @@
+# ignore dependency packages
+node_modules
+*.js.map

.github/actions/Locker/Locker.js

@@ -0,0 +1,43 @@
+"use strict";
+/*---------------------------------------------------------------------------------------------
+ *  Copyright (c) Microsoft Corporation. All rights reserved.
+ *  Licensed under the MIT License. See LICENSE in the project root for license information.
+ *--------------------------------------------------------------------------------------------*/
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.Locker = void 0;
+const utils_1 = require("../common/utils");
+const ActionBase_1 = require("../common/ActionBase");
+class Locker extends ActionBase_1.ActionBase {
+    constructor(github, daysSinceClose, daysSinceUpdate, labels, milestoneName, milestoneId, ignoreLabels, ignoreMilestoneNames, ignoreMilestoneIds, minimumVotes, maximumVotes) {
+        super(labels, milestoneName, milestoneId, ignoreLabels, ignoreMilestoneNames, ignoreMilestoneIds, minimumVotes, maximumVotes);
+        this.github = github;
+        this.daysSinceClose = daysSinceClose;
+        this.daysSinceUpdate = daysSinceUpdate;
+    }
+    async run() {
+        const closedTimestamp = utils_1.daysAgoToHumanReadbleDate(this.daysSinceClose);
+        const updatedTimestamp = utils_1.daysAgoToHumanReadbleDate(this.daysSinceUpdate);
+        const query = this.buildQuery((this.daysSinceClose ? `closed:<${closedTimestamp} ` : "") + (this.daysSinceUpdate ? `updated:<${updatedTimestamp} ` : "") + "is:closed is:unlocked");
+        for await (const page of this.github.query({ q: query })) {
+            await Promise.all(page.map(async (issue) => {
+                const hydrated = await issue.getIssue();
+                if (!hydrated.locked && hydrated.open === false && this.validateIssue(hydrated)
+                // TODO: Verify closed and updated timestamps
+                ) {
+                    console.log(`Locking issue ${hydrated.number}`);
+                    await issue.lockIssue();
+                }
+                else {
+                    if (hydrated.locked) {
+                        console.log(`Issue ${hydrated.number} is already locked. Ignoring`);
+                    }
+                    else if (hydrated.open) {
+                        console.log(`Issue ${hydrated.number} is open. Ignoring`);
+                    }
+                }
+            }));
+        }
+    }
+}
+exports.Locker = Locker;
+//# sourceMappingURL=Locker.js.map

.github/actions/Locker/Locker.ts

@@ -0,0 +1,55 @@
+/*---------------------------------------------------------------------------------------------
+ *  Copyright (c) Microsoft Corporation. All rights reserved.
+ *  Licensed under the MIT License. See LICENSE in the project root for license information.
+ *--------------------------------------------------------------------------------------------*/
+
+import { GitHub, Issue } from '../api/api'
+import { daysAgoToHumanReadbleDate } from '../common/utils'
+import { ActionBase } from '../common/ActionBase'
+
+export class Locker extends ActionBase {
+	constructor(
+		private github: GitHub,
+		private daysSinceClose: number,
+		private daysSinceUpdate: number,
+		labels?: string,
+		milestoneName?: string,
+		milestoneId?: string,
+		ignoreLabels?: string,
+		ignoreMilestoneNames?: string,
+		ignoreMilestoneIds?: string,
+		minimumVotes?: number,
+		maximumVotes?: number
+	)
+	{
+		super(labels, milestoneName, milestoneId, ignoreLabels, ignoreMilestoneNames, ignoreMilestoneIds, minimumVotes, maximumVotes);
+	}
+
+	async run() {
+		const closedTimestamp = daysAgoToHumanReadbleDate(this.daysSinceClose)
+		const updatedTimestamp = daysAgoToHumanReadbleDate(this.daysSinceUpdate)
+
+		const query = this.buildQuery((this.daysSinceClose ? `closed:<${closedTimestamp} ` : "") + (this.daysSinceUpdate ? `updated:<${updatedTimestamp} ` : "") + "is:closed is:unlocked");
+
+		for await (const page of this.github.query({ q: query })) {
+			await Promise.all(
+				page.map(async (issue) => {
+					const hydrated = await issue.getIssue()
+
+					if (!hydrated.locked && hydrated.open === false && this.validateIssue(hydrated)
+						// TODO: Verify closed and updated timestamps
+					) {
+						console.log(`Locking issue ${hydrated.number}`)
+						await issue.lockIssue()
+					} else {
+						if (hydrated.locked) {
+							console.log(`Issue ${hydrated.number} is already locked. Ignoring`)
+						} else if (hydrated.open) {
+							console.log(`Issue ${hydrated.number} is open. Ignoring`)
+						}
+					}
+				}),
+			)
+		}
+	}
+}

.github/actions/Locker/action.yml

@@ -0,0 +1,33 @@
+name: Locker
+description: Lock closed issues and PRs after some time has passed
+inputs:
+  token:
+    description: GitHub token with issue, comment, and label read/write permissions
+    default: ${{ github.token }}
+  daysSinceClose:
+    description: Days to wait since closing before locking the item
+    required: true
+  daysSinceUpdate:
+    description: days to wait since the last interaction before locking the item
+    required: true
+  milestoneName:
+    description: items with these milestones will be considered (name only, must match ID)
+  milestoneId:
+    description: items with these milestones will be considered (id only, must match name)
+  labels:
+    description: items with these labels will not be considered.  May be "*".
+  ignoreMilestoneNames:
+    description: items with these milestones will not be considered (names only, must match IDs).  May be "*".
+  ignoreMilestoneIds:
+    description: items with these milestones will not be considered (IDs only, must match names)
+  ignoreLabels:
+    description: items with these labels will not be considered
+  minimumVotes:
+    descriptions: Only issues with at least this many votes will be considered.
+  maximumVotes:
+    descriptions: Only issues fewer or equal to this many votes will be considered.
+  readonly:
+    description: If true, changes are not applied.
+runs:
+  using: 'node12'
+  main: 'index.js'

.github/actions/Locker/index.js

@@ -0,0 +1,20 @@
+"use strict";
+/*---------------------------------------------------------------------------------------------
+ *  Copyright (c) Microsoft Corporation. All rights reserved.
+ *  Licensed under the MIT License. See LICENSE in the project root for license information.
+ *--------------------------------------------------------------------------------------------*/
+Object.defineProperty(exports, "__esModule", { value: true });
+const utils_1 = require("../common/utils");
+const Locker_1 = require("./Locker");
+const Action_1 = require("../common/Action");
+class LockerAction extends Action_1.Action {
+    constructor() {
+        super(...arguments);
+        this.id = 'Locker';
+    }
+    async onTriggered(github) {
+        await new Locker_1.Locker(github, +utils_1.getRequiredInput('daysSinceClose'), +utils_1.getRequiredInput('daysSinceUpdate'), utils_1.getInput('labels') || undefined, utils_1.getInput('milestoneName') || undefined, utils_1.getInput('milestoneId') || undefined, utils_1.getInput('ignoreLabels') || undefined, utils_1.getInput('ignoreMilestoneNames') || undefined, utils_1.getInput('ignoreMilestoneIds') || undefined, +(utils_1.getInput('minimumVotes') || 0), +(utils_1.getInput('maximumVotes') || 9999999)).run();
+    }
+}
+new LockerAction().run(); // eslint-disable-line
+//# sourceMappingURL=index.js.map

.github/actions/Locker/index.ts

@@ -0,0 +1,31 @@
+/*---------------------------------------------------------------------------------------------
+ *  Copyright (c) Microsoft Corporation. All rights reserved.
+ *  Licensed under the MIT License. See LICENSE in the project root for license information.
+ *--------------------------------------------------------------------------------------------*/
+
+import { OctoKit } from '../api/octokit'
+import { getInput, getRequiredInput } from '../common/utils'
+import { Locker } from './Locker'
+import { Action } from '../common/Action'
+
+class LockerAction extends Action {
+	id = 'Locker'
+
+	async onTriggered(github: OctoKit) {
+		await new Locker(
+			github,
+			+getRequiredInput('daysSinceClose'),
+			+getRequiredInput('daysSinceUpdate'),
+			getInput('labels') || undefined,
+			getInput('milestoneName') || undefined,
+			getInput('milestoneId') || undefined,
+			getInput('ignoreLabels') || undefined,
+			getInput('ignoreMilestoneNames') || undefined,
+			getInput('ignoreMilestoneIds') || undefined,
+			+(getInput('minimumVotes') || 0),
+			+(getInput('maximumVotes') || 9999999)
+		).run()
+	}
+}
+
+new LockerAction().run() // eslint-disable-line

.github/actions/Reopener/Reopener.js

@@ -0,0 +1,72 @@
+"use strict";
+/*---------------------------------------------------------------------------------------------
+ *  Copyright (c) Microsoft Corporation. All rights reserved.
+ *  Licensed under the MIT License. See LICENSE in the project root for license information.
+ *--------------------------------------------------------------------------------------------*/
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.Reopener = void 0;
+const ActionBase_1 = require("../common/ActionBase");
+class Reopener extends ActionBase_1.ActionBase {
+    constructor(github, alsoApplyToOpenIssues, addLabels, removeLabels, reopenComment, setMilestoneId, labels, milestoneName, milestoneId, ignoreLabels, ignoreMilestoneNames, ignoreMilestoneIds, minimumVotes, maximumVotes) {
+        super(labels, milestoneName, milestoneId, ignoreLabels, ignoreMilestoneNames, ignoreMilestoneIds, minimumVotes, maximumVotes);
+        this.github = github;
+        this.alsoApplyToOpenIssues = alsoApplyToOpenIssues;
+        this.addLabels = addLabels;
+        this.removeLabels = removeLabels;
+        this.reopenComment = reopenComment;
+        this.setMilestoneId = setMilestoneId;
+    }
+    async run() {
+        const addLabelsSet = this.addLabels ? this.addLabels.split(',') : [];
+        const removeLabelsSet = this.removeLabels ? this.removeLabels.split(',') : [];
+        console.log(`alsoApplyToOpenIssues: ${this.alsoApplyToOpenIssues}`);
+        const query = this.buildQuery((this.alsoApplyToOpenIssues ? "" : "is:closed ") + "is:unlocked");
+        for await (const page of this.github.query({ q: query })) {
+            await Promise.all(page.map(async (issue) => {
+                const hydrated = await issue.getIssue();
+                if (!hydrated.locked && (this.alsoApplyToOpenIssues || hydrated.open === false) && this.validateIssue(hydrated)
+                // TODO: Verify closed and updated timestamps
+                ) {
+                    if (hydrated.open === false) {
+                        console.log(`Reopening issue ${hydrated.number}`);
+                        await issue.reopenIssue();
+                    }
+                    if (this.setMilestoneId != undefined) {
+                        console.log(`Setting milestone of issue ${hydrated.number} to id ${+this.setMilestoneId}`);
+                        await issue.setMilestone(+this.setMilestoneId);
+                    }
+                    if (removeLabelsSet.length > 0) {
+                        for (const removeLabel of removeLabelsSet) {
+                            if (removeLabel && removeLabel.length > 0) {
+                                console.log(`Removing label on issue ${hydrated.number}: ${removeLabel}`);
+                                await issue.removeLabel(removeLabel);
+                            }
+                        }
+                    }
+                    if (addLabelsSet.length > 0) {
+                        for (const addLabel of addLabelsSet) {
+                            if (addLabel && addLabel.length > 0) {
+                                console.log(`Adding label on issue ${hydrated.number}: ${addLabel}`);
+                                await issue.addLabel(addLabel);
+                            }
+                        }
+                    }
+                    if (this.reopenComment) {
+                        console.log(`Posting comment to issue ${hydrated.number}.`);
+                        await issue.postComment(this.reopenComment);
+                    }
+                }
+                else {
+                    if (hydrated.locked) {
+                        console.log(`Issue ${hydrated.number} is locked. Ignoring`);
+                    }
+                    else if (!this.alsoApplyToOpenIssues && hydrated.open) {
+                        console.log(`Issue ${hydrated.number} is open. Ignoring`);
+                    }
+                }
+            }));
+        }
+    }
+}
+exports.Reopener = Reopener;
+//# sourceMappingURL=Reopener.js.map

.github/actions/Reopener/Reopener.ts

@@ -0,0 +1,84 @@
+/*---------------------------------------------------------------------------------------------
+ *  Copyright (c) Microsoft Corporation. All rights reserved.
+ *  Licensed under the MIT License. See LICENSE in the project root for license information.
+ *--------------------------------------------------------------------------------------------*/
+
+import { GitHub, Issue } from '../api/api'
+import { ActionBase } from '../common/ActionBase'
+
+export class Reopener extends ActionBase {
+	constructor(
+		private github: GitHub,
+		private alsoApplyToOpenIssues: boolean,
+		private addLabels?: string,
+		private removeLabels?: string,
+		private reopenComment?: string,
+		private setMilestoneId?: string,
+		labels?: string,
+		milestoneName?: string,
+		milestoneId?: string,
+		ignoreLabels?: string,
+		ignoreMilestoneNames?: string,
+		ignoreMilestoneIds?: string,
+		minimumVotes?: number,
+		maximumVotes?: number
+	)
+	{
+		super(labels, milestoneName, milestoneId, ignoreLabels, ignoreMilestoneNames, ignoreMilestoneIds, minimumVotes, maximumVotes);
+	}
+
+	async run() {
+		const addLabelsSet = this.addLabels ? this.addLabels.split(',') : [];
+		const removeLabelsSet = this.removeLabels ? this.removeLabels.split(',') : [];
+
+		console.log(`alsoApplyToOpenIssues: ${this.alsoApplyToOpenIssues}`);
+
+		const query = this.buildQuery((this.alsoApplyToOpenIssues ? "": "is:closed ") + "is:unlocked");
+
+		for await (const page of this.github.query({ q: query })) {
+			await Promise.all(
+				page.map(async (issue) => {
+					const hydrated = await issue.getIssue()
+					if (!hydrated.locked && (this.alsoApplyToOpenIssues || hydrated.open === false) && this.validateIssue(hydrated)
+						// TODO: Verify closed and updated timestamps
+					) {
+						if (hydrated.open === false) {
+							console.log(`Reopening issue ${hydrated.number}`)
+							await issue.reopenIssue()
+						}
+						if (this.setMilestoneId != undefined) {
+							console.log(`Setting milestone of issue ${hydrated.number} to id ${+this.setMilestoneId}`)
+							await issue.setMilestone(+this.setMilestoneId)
+						}
+						if (removeLabelsSet.length > 0) {
+							for (const removeLabel of removeLabelsSet) {
+								if (removeLabel && removeLabel.length > 0) {
+									console.log(`Removing label on issue ${hydrated.number}: ${removeLabel}`)
+									await issue.removeLabel(removeLabel)
+								}
+							}
+						}
+						if (addLabelsSet.length > 0) {
+							for (const addLabel of addLabelsSet) {
+								if (addLabel && addLabel.length > 0) {
+									console.log(`Adding label on issue ${hydrated.number}: ${addLabel}`)
+									await issue.addLabel(addLabel)
+								}
+							}
+						}
+						if (this.reopenComment) {
+							console.log(`Posting comment to issue ${hydrated.number}.`)
+							await issue.postComment(this.reopenComment)
+						}
+					} else {
+						if (hydrated.locked) {
+							console.log(`Issue ${hydrated.number} is locked. Ignoring`)
+						} else if (!this.alsoApplyToOpenIssues && hydrated.open) {
+							console.log(`Issue ${hydrated.number} is open. Ignoring`)
+						}
+					}
+				}),
+			)
+		}
+	}
+}

.github/actions/Reopener/action.yml

@@ -0,0 +1,37 @@
+name: Locker
+description: Lock closed issues and PRs after some time has passed
+inputs:
+  token:
+    description: GitHub token with issue, comment, and label read/write permissions
+    default: ${{ github.token }}
+  alsoApplyToOpenIssues:
+    description: If true, applies to issues that are already opened (to add/remove labels, etc., but not reopen).
+  addLabels:
+    description: Labels to add to issue as it is reopend.
+  reopenComment:
+    description: Comment to add upon reopening the issue.
+  setMilestoneId:
+    description: Milestone to set reopened issue to.
+  removeLabels:
+    description: Labels to remove from issue as it is reopened.
+  milestoneName:
+    description: items with these milestones will be considered (name only, must match ID)
+  milestoneId:
+    description: items with these milestones will be considered (id only, must match name)
+  labels:
+    description: items with these labels will not be considered.  May be "*".
+  ignoreMilestoneNames:
+    description: items with these milestones will not be considered (names only, must match IDs).  May be "*".
+  ignoreMilestoneIds:
+    description: items with these milestones will not be considered (IDs only, must match names)
+  ignoreLabels:
+    description: items with these labels will not be considered
+  minimumVotes:
+    descriptions: Only issues with at least this many votes will be considered.
+  maximumVotes:
+    descriptions: Only issues fewer or equal to this many votes will be considered.
+  readonly:
+    description: If true, changes are not applied.
+runs:
+  using: 'node12'
+  main: 'index.js'

.github/actions/Reopener/index.js

@@ -0,0 +1,21 @@
+"use strict";
+/*---------------------------------------------------------------------------------------------
+ *  Copyright (c) Microsoft Corporation. All rights reserved.
+ *  Licensed under the MIT License. See LICENSE in the project root for license information.
+ *--------------------------------------------------------------------------------------------*/
+Object.defineProperty(exports, "__esModule", { value: true });
+const utils_1 = require("../common/utils");
+const Reopener_1 = require("./Reopener");
+const Action_1 = require("../common/Action");
+class ReopenerAction extends Action_1.Action {
+    constructor() {
+        super(...arguments);
+        this.id = 'Locker';
+    }
+    async onTriggered(github) {
+        const alsoApplyToOpenIssues = utils_1.getInput('alsoApplyToOpenIssues');
+        await new Reopener_1.Reopener(github, alsoApplyToOpenIssues != undefined && alsoApplyToOpenIssues.toLowerCase() == 'true', utils_1.getInput('addLabels') || undefined, utils_1.getInput('removeLabels') || undefined, utils_1.getInput('reopenComment') || '', utils_1.getInput('setMilestoneId') || undefined, utils_1.getInput('labels') || undefined, utils_1.getInput('milestoneName') || undefined, utils_1.getInput('milestoneId') || undefined, utils_1.getInput('ignoreLabels') || undefined, utils_1.getInput('ignoreMilestoneNames') || undefined, utils_1.getInput('ignoreMilestoneIds') || undefined, +(utils_1.getInput('minimumVotes') || 0), +(utils_1.getInput('maximumVotes') || 9999999)).run();
+    }
+}
+new ReopenerAction().run(); // eslint-disable-line
+//# sourceMappingURL=index.js.map

.github/actions/Reopener/index.ts

@@ -0,0 +1,35 @@
+/*---------------------------------------------------------------------------------------------
+ *  Copyright (c) Microsoft Corporation. All rights reserved.
+ *  Licensed under the MIT License. See LICENSE in the project root for license information.
+ *--------------------------------------------------------------------------------------------*/
+
+import { OctoKit } from '../api/octokit'
+import { getInput, getRequiredInput } from '../common/utils'
+import { Reopener } from './Reopener'
+import { Action } from '../common/Action'
+
+class ReopenerAction extends Action {
+	id = 'Locker'
+
+	async onTriggered(github: OctoKit) {
+		const alsoApplyToOpenIssues: string | undefined = getInput('alsoApplyToOpenIssues');
+		await new Reopener(
+			github,
+			alsoApplyToOpenIssues != undefined && alsoApplyToOpenIssues.toLowerCase() == 'true',
+			getInput('addLabels') || undefined,
+			getInput('removeLabels') || undefined,
+			getInput('reopenComment') || '',
+			getInput('setMilestoneId') || undefined,
+			getInput('labels') || undefined,
+			getInput('milestoneName') || undefined,
+			getInput('milestoneId') || undefined,
+			getInput('ignoreLabels') || undefined,
+			getInput('ignoreMilestoneNames') || undefined,
+			getInput('ignoreMilestoneIds') || undefined,
+			+(getInput('minimumVotes') || 0),
+			+(getInput('maximumVotes') || 9999999)
+		).run()
+	}
+}
+
+new ReopenerAction().run() // eslint-disable-line

.github/actions/StaleCloser/StaleCloser.js

@@ -0,0 +1,106 @@
+"use strict";
+/*---------------------------------------------------------------------------------------------
+ *  Copyright (c) Microsoft Corporation. All rights reserved.
+ *  Licensed under the MIT License. See LICENSE in the project root for license information.
+ *--------------------------------------------------------------------------------------------*/
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.StaleCloser = void 0;
+const ActionBase_1 = require("../common/ActionBase");
+const utils_1 = require("../common/utils");
+class StaleCloser extends ActionBase_1.ActionBase {
+    constructor(github, closeDays, labels, closeComment, pingDays, pingComment, additionalTeam, addLabels, removeLabels, setMilestoneId, milestoneName, milestoneId, ignoreLabels, ignoreMilestoneNames, ignoreMilestoneIds, minimumVotes, maximumVotes, involves) {
+        super(labels, milestoneName, milestoneId, ignoreLabels, ignoreMilestoneNames, ignoreMilestoneIds, minimumVotes, maximumVotes, involves);
+        this.github = github;
+        this.closeDays = closeDays;
+        this.closeComment = closeComment;
+        this.pingDays = pingDays;
+        this.pingComment = pingComment;
+        this.additionalTeam = additionalTeam;
+        this.addLabels = addLabels;
+        this.removeLabels = removeLabels;
+        this.setMilestoneId = setMilestoneId;
+    }
+    async run() {
+        const updatedTimestamp = utils_1.daysAgoToHumanReadbleDate(this.closeDays);
+        const pingTimestamp = this.pingDays ? utils_1.daysAgoToTimestamp(this.pingDays) : undefined;
+        const query = this.buildQuery((this.closeDays ? `updated:<${updatedTimestamp} ` : "") + "is:open is:unlocked");
+        const addLabelsSet = this.addLabels ? this.addLabels.split(',') : [];
+        const removeLabelsSet = this.removeLabels ? this.removeLabels.split(',') : [];
+        for await (const page of this.github.query({ q: query })) {
+            for (const issue of page) {
+                const hydrated = await issue.getIssue();
+                const lastCommentIterator = await issue.getComments(true).next();
+                if (lastCommentIterator.done) {
+                    throw Error('Unexpected comment data');
+                }
+                const lastComment = lastCommentIterator.value[0];
+                if (hydrated.open && this.validateIssue(hydrated)
+                // TODO: Verify updated timestamp
+                ) {
+                    if (!lastComment ||
+                        lastComment.author.isGitHubApp ||
+                        pingTimestamp == undefined ||
+                        // TODO: List the collaborators once per go rather than checking a single user each issue
+                        this.additionalTeam.includes(lastComment.author.name) ||
+                        await issue.hasWriteAccess(lastComment.author)) {
+                        if (pingTimestamp != undefined) {
+                            if (lastComment) {
+                                console.log(`Last comment on issue ${hydrated.number} by ${lastComment.author.name}. Closing.`);
+                            }
+                            else {
+                                console.log(`No comments on issue ${hydrated.number}. Closing.`);
+                            }
+                        }
+                        if (this.closeComment) {
+                            console.log(`Posting comment on issue ${hydrated.number}`);
+                            await issue.postComment(this.closeComment);
+                        }
+                        if (removeLabelsSet.length > 0) {
+                            for (const removeLabel of removeLabelsSet) {
+                                if (removeLabel && removeLabel.length > 0) {
+                                    console.log(`Removing label on issue ${hydrated.number}: ${removeLabel}`);
+                                    await issue.removeLabel(removeLabel);
+                                }
+                            }
+                        }
+                        if (addLabelsSet.length > 0) {
+                            for (const addLabel of addLabelsSet) {
+                                if (addLabel && addLabel.length > 0) {
+                                    console.log(`Adding label on issue ${hydrated.number}: ${addLabel}`);
+                                    await issue.addLabel(addLabel);
+                                }
+                            }
+                        }
+                        await issue.closeIssue();
+                        if (this.setMilestoneId != undefined) {
+                            console.log(`Setting milestone of issue ${hydrated.number} to id ${+this.setMilestoneId}`);
+                            await issue.setMilestone(+this.setMilestoneId);
+                        }
+                        console.log(`Closing issue ${hydrated.number}.`);
+                    }
+                    else {
+                        // Ping
+                        if (hydrated.updatedAt < pingTimestamp && hydrated.assignee) {
+                            console.log(`Last comment on issue ${hydrated.number} by ${lastComment.author.name}. Pinging @${hydrated.assignee}`);
+                            if (this.pingComment) {
+                                await issue.postComment(this.pingComment
+                                    .replace('${assignee}', hydrated.assignee)
+                                    .replace('${author}', hydrated.author.name));
+                            }
+                        }
+                        else {
+                            console.log(`Last comment on issue ${hydrated.number} by ${lastComment.author.name}. Skipping.${hydrated.assignee ? ' cc @' + hydrated.assignee : ''}`);
+                        }
+                    }
+                }
+                else {
+                    if (!hydrated.open) {
+                        console.log(`Issue ${hydrated.number} is not open. Ignoring`);
+                    }
+                }
+            }
+        }
+    }
+}
+exports.StaleCloser = StaleCloser;
+//# sourceMappingURL=StaleCloser.js.map

.github/actions/StaleCloser/StaleCloser.ts

@@ -0,0 +1,128 @@
+/*---------------------------------------------------------------------------------------------
+ *  Copyright (c) Microsoft Corporation. All rights reserved.
+ *  Licensed under the MIT License. See LICENSE in the project root for license information.
+ *--------------------------------------------------------------------------------------------*/
+
+import { GitHub } from '../api/api'
+import { ActionBase } from '../common/ActionBase'
+import { daysAgoToHumanReadbleDate, daysAgoToTimestamp } from '../common/utils'
+
+export class StaleCloser extends ActionBase {
+	constructor(
+		private github: GitHub,
+		private closeDays: number,
+		labels: string,
+		private closeComment: string,
+		private pingDays: number,
+		private pingComment: string,
+		private additionalTeam: string[],
+		private addLabels?: string,
+		private removeLabels?: string,
+		private setMilestoneId?: string,
+		milestoneName?: string,
+		milestoneId?: string,
+		ignoreLabels?: string,
+		ignoreMilestoneNames?: string,
+		ignoreMilestoneIds?: string,
+		minimumVotes?: number,
+		maximumVotes?: number,
+		involves?: string
+	)
+	{
+		super(labels, milestoneName, milestoneId, ignoreLabels, ignoreMilestoneNames, ignoreMilestoneIds, minimumVotes, maximumVotes, involves);
+	}
+
+	async run() {
+		const updatedTimestamp = daysAgoToHumanReadbleDate(this.closeDays)
+		const pingTimestamp = this.pingDays ? daysAgoToTimestamp(this.pingDays) : undefined;
+
+		const query = this.buildQuery((this.closeDays ? `updated:<${updatedTimestamp} ` : "") + "is:open is:unlocked");
+
+		const addLabelsSet = this.addLabels ? this.addLabels.split(',') : [];
+		const removeLabelsSet = this.removeLabels ? this.removeLabels.split(',') : [];
+
+		for await (const page of this.github.query({ q: query })) {
+			for (const issue of page) {
+				const hydrated = await issue.getIssue()
+				const lastCommentIterator = await issue.getComments(true).next()
+				if (lastCommentIterator.done) {
+					throw Error('Unexpected comment data')
+				}
+				const lastComment = lastCommentIterator.value[0]
+
+				if (hydrated.open && this.validateIssue(hydrated)
+					// TODO: Verify updated timestamp
+				) {
+					if (
+						!lastComment ||
+						lastComment.author.isGitHubApp ||
+						pingTimestamp == undefined ||
+						// TODO: List the collaborators once per go rather than checking a single user each issue
+						this.additionalTeam.includes(lastComment.author.name) ||
+						await issue.hasWriteAccess(lastComment.author)
+					) {
+						if (pingTimestamp != undefined) {
+							if (lastComment) {
+								console.log(
+									`Last comment on issue ${hydrated.number} by ${lastComment.author.name}. Closing.`,
+								)
+							} else {
+								console.log(`No comments on issue ${hydrated.number}. Closing.`)
+							}
+						}
+						if (this.closeComment) {
+							console.log(`Posting comment on issue ${hydrated.number}`)
+							await issue.postComment(this.closeComment)
+						}
+						if (removeLabelsSet.length > 0) {
+							for (const removeLabel of removeLabelsSet) {
+								if (removeLabel && removeLabel.length > 0) {
+									console.log(`Removing label on issue ${hydrated.number}: ${removeLabel}`)
+									await issue.removeLabel(removeLabel)
+								}
+							}
+						}
+						if (addLabelsSet.length > 0) {
+							for (const addLabel of addLabelsSet) {
+								if (addLabel && addLabel.length > 0) {
+									console.log(`Adding label on issue ${hydrated.number}: ${addLabel}`)
+									await issue.addLabel(addLabel)
+								}
+							}
+						}
+						await issue.closeIssue()
+						if (this.setMilestoneId != undefined) {
+							console.log(`Setting milestone of issue ${hydrated.number} to id ${+this.setMilestoneId}`)
+							await issue.setMilestone(+this.setMilestoneId)
+						}
+						console.log(`Closing issue ${hydrated.number}.`)
+					} else {
+						// Ping
+						if (hydrated.updatedAt < pingTimestamp && hydrated.assignee) {
+							console.log(
+								`Last comment on issue ${hydrated.number} by ${lastComment.author.name}. Pinging @${hydrated.assignee}`,
+							)
+							if (this.pingComment) {
+								await issue.postComment(
+									this.pingComment
+										.replace('${assignee}', hydrated.assignee)
+										.replace('${author}', hydrated.author.name),
+								)
+							}
+						} else {
+							console.log(
+								`Last comment on issue ${hydrated.number} by ${lastComment.author.name}. Skipping.${
+									hydrated.assignee ? ' cc @' + hydrated.assignee : ''
+								}`,
+							)
+						}
+					}
+				} else {
+					if (!hydrated.open) {
+						console.log(`Issue ${hydrated.number} is not open. Ignoring`)
+					}
+				}
+			}
+		}
+	}
+}

.github/actions/StaleCloser/action.yml

@@ -0,0 +1,47 @@
+name: Stale Issue Closer
+description: Close issues that are marked with a specified label and were last interacted with by a contributor or bot
+inputs:
+  token:
+    description: GitHub token with issue, comment, and label read/write permissions
+    default: ${{ github.token }}
+  closeDays:
+    description: Days to wait before closing the issue
+    required: true
+  closeComment:
+    description: Comment to add upon closing the issue
+  pingDays:
+    description: Days to wait before pinging the assignee, if any.  If set, issue is not closed if there is an assignee.
+  additionalTeam:
+    description: Pipe-separated list of additional users to treat as team members
+  pingComment:
+    description: Comment to add when pinging assignee. ${assignee} and ${author} are replaced.
+  milestoneName:
+    description: items with these milestones will be considered (name only, must match ID)
+  milestoneId:
+    description: items with these milestones will be considered (id only, must match name)
+  labels:
+    description: items with these labels will not be considered.  May be "*".
+    required: true
+  ignoreMilestoneNames:
+    description: items with these milestones will not be considered (names only, must match IDs).  May be "*".
+  ignoreMilestoneIds:
+    description: items with these milestones will not be considered (IDs only, must match names)
+  ignoreLabels:
+    description: items with these labels will not be considered
+  addLabels:
+    description: Labels to add to issue as it is closed.
+  removeLabels:
+    description: Labels to remove from issue as it is closed.
+  setMilestoneId:
+    description: Milestone to set closed issue to.
+  minimumVotes:
+    descriptions: Only issues with at least this many votes will be considered.
+  maximumVotes:
+    descriptions: Only issues fewer or equal to this many votes will be considered.
+  involves:
+    descriptions: Qualifier to find issues that in some way involve a certain user either as an author, assignee, or mentions.
+  readonly:
+    description: If true, changes are not applied.
+runs:
+  using: 'node12'
+  main: 'index.js'

.github/actions/StaleCloser/index.js

@@ -0,0 +1,21 @@
+"use strict";
+/*---------------------------------------------------------------------------------------------
+ *  Copyright (c) Microsoft Corporation. All rights reserved.
+ *  Licensed under the MIT License. See LICENSE in the project root for license information.
+ *--------------------------------------------------------------------------------------------*/
+Object.defineProperty(exports, "__esModule", { value: true });
+const utils_1 = require("../common/utils");
+const StaleCloser_1 = require("./StaleCloser");
+const Action_1 = require("../common/Action");
+class StaleCloserAction extends Action_1.Action {
+    constructor() {
+        super(...arguments);
+        this.id = 'StaleCloser';
+    }
+    async onTriggered(github) {
+        var _a;
+        await new StaleCloser_1.StaleCloser(github, +utils_1.getRequiredInput('closeDays'), utils_1.getRequiredInput('labels'), utils_1.getInput('closeComment') || '', +(utils_1.getInput('pingDays') || 0), utils_1.getInput('pingComment') || '', ((_a = utils_1.getInput('additionalTeam')) !== null && _a !== void 0 ? _a : '').split(','), utils_1.getInput('addLabels') || undefined, utils_1.getInput('removeLabels') || undefined, utils_1.getInput('setMilestoneId') || undefined, utils_1.getInput('milestoneName') || undefined, utils_1.getInput('milestoneId') || undefined, utils_1.getInput('ignoreLabels') || undefined, utils_1.getInput('ignoreMilestoneNames') || undefined, utils_1.getInput('ignoreMilestoneIds') || undefined, +(utils_1.getInput('minimumVotes') || 0), +(utils_1.getInput('maximumVotes') || 9999999), utils_1.getInput('involves') || undefined).run();
+    }
+}
+new StaleCloserAction().run(); // eslint-disable-line
+//# sourceMappingURL=index.js.map

.github/actions/StaleCloser/index.ts

@@ -0,0 +1,38 @@
+/*---------------------------------------------------------------------------------------------
+ *  Copyright (c) Microsoft Corporation. All rights reserved.
+ *  Licensed under the MIT License. See LICENSE in the project root for license information.
+ *--------------------------------------------------------------------------------------------*/
+
+import { OctoKit } from '../api/octokit'
+import { getInput, getRequiredInput } from '../common/utils'
+import { StaleCloser } from './StaleCloser'
+import { Action } from '../common/Action'
+
+class StaleCloserAction extends Action {
+	id = 'StaleCloser'
+
+	async onTriggered(github: OctoKit) {
+		await new StaleCloser(
+			github,
+			+getRequiredInput('closeDays'),
+			getRequiredInput('labels'),
+			getInput('closeComment') || '',
+			+(getInput('pingDays') || 0),
+			getInput('pingComment') || '',
+			(getInput('additionalTeam') ?? '').split(','),
+			getInput('addLabels') || undefined,
+			getInput('removeLabels') || undefined,
+			getInput('setMilestoneId') || undefined,
+			getInput('milestoneName') || undefined,
+			getInput('milestoneId') || undefined,
+			getInput('ignoreLabels') || undefined,
+			getInput('ignoreMilestoneNames') || undefined,
+			getInput('ignoreMilestoneIds') || undefined,
+			+(getInput('minimumVotes') || 0),
+			+(getInput('maximumVotes') || 9999999),
+			getInput('involves') || undefined
+		).run()
+	}
+}
+
+new StaleCloserAction().run() // eslint-disable-line

.github/actions/api/api.js

@@ -0,0 +1,7 @@
+"use strict";
+/*---------------------------------------------------------------------------------------------
+ *  Copyright (c) Microsoft Corporation. All rights reserved.
+ *  Licensed under the MIT License. See LICENSE in the project root for license information.
+ *--------------------------------------------------------------------------------------------*/
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=api.js.map

.github/actions/api/api.ts

@@ -0,0 +1,100 @@
+/*---------------------------------------------------------------------------------------------
+ *  Copyright (c) Microsoft Corporation. All rights reserved.
+ *  Licensed under the MIT License. See LICENSE in the project root for license information.
+ *--------------------------------------------------------------------------------------------*/
+
+export interface GitHub {
+	query(query: Query): AsyncIterableIterator<GitHubIssue[]>
+
+	hasWriteAccess(user: User): Promise<boolean>
+
+	repoHasLabel(label: string): Promise<boolean>
+	createLabel(label: string, color: string, description: string): Promise<void>
+	deleteLabel(label: string): Promise<void>
+
+	readConfig(path: string): Promise<any>
+
+	dispatch(title: string): Promise<void>
+
+	createIssue(owner: string, repo: string, title: string, body: string): Promise<void>
+
+	releaseContainsCommit(release: string, commit: string): Promise<'yes' | 'no' | 'unknown'>
+}
+
+export interface GitHubIssue extends GitHub {
+	getIssue(): Promise<Issue>
+
+	postComment(body: string): Promise<void>
+	deleteComment(id: number): Promise<void>
+	getComments(last?: boolean): AsyncIterableIterator<Comment[]>
+
+	closeIssue(): Promise<void>
+	lockIssue(): Promise<void>
+	reopenIssue(): Promise<void>
+
+	setMilestone(milestoneId: number): Promise<void>
+
+	addLabel(label: string): Promise<void>
+	removeLabel(label: string): Promise<void>
+
+	addAssignee(assignee: string): Promise<void>
+	removeAssignee(assignee: string): Promise<void>
+
+	getClosingInfo(): Promise<{ hash: string | undefined; timestamp: number } | undefined>
+}
+
+type SortVar =
+	| 'comments'
+	| 'reactions'
+	| 'reactions-+1'
+	| 'reactions--1'
+	| 'reactions-smile'
+	| 'reactions-thinking_face'
+	| 'reactions-heart'
+	| 'reactions-tada'
+	| 'interactions'
+	| 'created'
+	| 'updated'
+type SortOrder = 'asc' | 'desc'
+export type Reactions = {
+	'+1': number
+	'-1': number
+	laugh: number
+	hooray: number
+	confused: number
+	heart: number
+	rocket: number
+	eyes: number
+}
+
+export interface User {
+	name: string
+	isGitHubApp?: boolean
+}
+export interface Comment {
+	author: User
+	body: string
+	id: number
+	timestamp: number
+}
+export interface Issue {
+	author: User
+	body: string
+	title: string
+	labels: string[]
+	open: boolean
+	locked: boolean
+	number: number
+	numComments: number
+	reactions: Reactions
+	milestoneId: number | null
+	assignee?: string
+	createdAt: number
+	updatedAt: number
+	closedAt?: number
+}
+export interface Query {
+	q: string
+	sort?: SortVar
+	order?: SortOrder
+}

.github/actions/api/octokit.js

@@ -0,0 +1,405 @@
+"use strict";
+/*---------------------------------------------------------------------------------------------
+ *  Copyright (c) Microsoft Corporation. All rights reserved.
+ *  Licensed under the MIT License. See LICENSE in the project root for license information.
+ *--------------------------------------------------------------------------------------------*/
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.OctoKitIssue = exports.OctoKit = exports.getNumRequests = void 0;
+const core_1 = require("@actions/core");
+const github_1 = require("@actions/github");
+const child_process_1 = require("child_process");
+let numRequests = 0;
+exports.getNumRequests = () => numRequests;
+class OctoKit {
+    constructor(token, params, options = { readonly: false }) {
+        this.token = token;
+        this.params = params;
+        this.options = options;
+        // when in readonly mode, record labels just-created so at to not throw unneccesary errors
+        this.mockLabels = new Set();
+        this.writeAccessCache = {};
+        this._octokit = new github_1.GitHub(token);
+    }
+    get octokit() {
+        numRequests++;
+        return this._octokit;
+    }
+    // TODO: just iterate over the issues in a page here instead of making caller do it
+    async *query(query) {
+        const q = query.q + ` repo:${this.params.owner}/${this.params.repo}`;
+        console.log(`Querying for ${q}:`);
+        const options = this.octokit.search.issuesAndPullRequests.endpoint.merge({
+            ...query,
+            q,
+            per_page: 100,
+            headers: { Accept: 'application/vnd.github.squirrel-girl-preview+json' },
+        });
+        let pageNum = 0;
+        const timeout = async () => {
+            if (pageNum < 2) {
+                /* pass */
+            }
+            else if (pageNum < 4) {
+                await new Promise((resolve) => setTimeout(resolve, 3000));
+            }
+            else {
+                await new Promise((resolve) => setTimeout(resolve, 30000));
+            }
+        };
+        for await (const pageResponse of this.octokit.paginate.iterator(options)) {
+            await timeout();
+            numRequests++;
+            const page = pageResponse.data;
+            console.log(`Page ${++pageNum}: ${page.map(({ number }) => number).join(' ')}`);
+            yield page.map((issue) => new OctoKitIssue(this.token, this.params, this.octokitIssueToIssue(issue), this.options));
+        }
+    }
+    async createIssue(owner, repo, title, body) {
+        core_1.debug(`Creating issue \`${title}\` on ${owner}/${repo}`);
+        if (!this.options.readonly)
+            await this.octokit.issues.create({ owner, repo, title, body });
+    }
+    octokitIssueToIssue(issue) {
+        var _a, _b, _c, _d, _e, _f;
+        return {
+            author: { name: issue.user.login, isGitHubApp: issue.user.type === 'Bot' },
+            body: issue.body,
+            number: issue.number,
+            title: issue.title,
+            labels: issue.labels.map((label) => label.name),
+            open: issue.state === 'open',
+            locked: issue.locked,
+            numComments: issue.comments,
+            reactions: issue.reactions,
+            assignee: (_b = (_a = issue.assignee) === null || _a === void 0 ? void 0 : _a.login) !== null && _b !== void 0 ? _b : (_d = (_c = issue.assignees) === null || _c === void 0 ? void 0 : _c[0]) === null || _d === void 0 ? void 0 : _d.login,
+            milestoneId: (_f = (_e = issue.milestone) === null || _e === void 0 ? void 0 : _e.number) !== null && _f !== void 0 ? _f : null,
+            createdAt: +new Date(issue.created_at),
+            updatedAt: +new Date(issue.updated_at),
+            closedAt: issue.closed_at ? +new Date(issue.closed_at) : undefined,
+        };
+    }
+    async hasWriteAccess(user) {
+        if (user.name in this.writeAccessCache) {
+            core_1.debug('Got permissions from cache for ' + user);
+            return this.writeAccessCache[user.name];
+        }
+        core_1.debug('Fetching permissions for ' + user);
+        const permissions = (await this.octokit.repos.getCollaboratorPermissionLevel({
+            ...this.params,
+            username: user.name,
+        })).data.permission;
+        return (this.writeAccessCache[user.name] = permissions === 'admin' || permissions === 'write');
+    }
+    async repoHasLabel(name) {
+        try {
+            await this.octokit.issues.getLabel({ ...this.params, name });
+            return true;
+        }
+        catch (err) {
+            if (err.status === 404) {
+                return this.options.readonly && this.mockLabels.has(name);
+            }
+            throw err;
+        }
+    }
+    async createLabel(name, color, description) {
+        core_1.debug('Creating label ' + name);
+        if (!this.options.readonly)
+            await this.octokit.issues.createLabel({ ...this.params, color, description, name });
+        else
+            this.mockLabels.add(name);
+    }
+    async deleteLabel(name) {
+        core_1.debug('Deleting label ' + name);
+        try {
+            if (!this.options.readonly)
+                await this.octokit.issues.deleteLabel({ ...this.params, name });
+        }
+        catch (err) {
+            if (err.status === 404) {
+                return;
+            }
+            throw err;
+        }
+    }
+    async readConfig(path) {
+        core_1.debug('Reading config at ' + path);
+        const repoPath = `.github/${path}.json`;
+        try {
+            const data = (await this.octokit.repos.getContents({ ...this.params, path: repoPath })).data;
+            if ('type' in data && data.type === 'file') {
+                if (data.encoding === 'base64' && data.content) {
+                    return JSON.parse(Buffer.from(data.content, 'base64').toString('utf-8'));
+                }
+                throw Error(`Could not read contents "${data.content}" in encoding "${data.encoding}"`);
+            }
+            throw Error('Found directory at config path when expecting file' + JSON.stringify(data));
+        }
+        catch (e) {
+            throw Error('Error with config file at ' + repoPath + ': ' + JSON.stringify(e));
+        }
+    }
+    async releaseContainsCommit(release, commit) {
+        return new Promise((resolve, reject) => child_process_1.exec(`git -C ./repo merge-base --is-ancestor ${commit} ${release}`, (err) => {
+            if (!err || err.code === 1) {
+                resolve(!err ? 'yes' : 'no');
+            }
+            else if (err.message.includes(`Not a valid commit name ${release}`)) {
+                // release branch is forked. Probably in endgame. Not released.
+                resolve('no');
+            }
+            else if (err.message.includes(`Not a valid commit name ${commit}`)) {
+                // commit is probably in a different repo.
+                resolve('unknown');
+            }
+            else {
+                reject(err);
+            }
+        }));
+    }
+    async dispatch(title) {
+        core_1.debug('Dispatching ' + title);
+        if (!this.options.readonly)
+            await this.octokit.repos.createDispatchEvent({ ...this.params, event_type: title });
+    }
+}
+exports.OctoKit = OctoKit;
+class OctoKitIssue extends OctoKit {
+    constructor(token, params, issueData, options = { readonly: false }) {
+        super(token, params, options);
+        this.params = params;
+        this.issueData = issueData;
+        console.log('running bot on issue', issueData.number);
+    }
+    async addAssignee(assignee) {
+        core_1.debug('Adding assignee ' + assignee + ' to ' + this.issueData.number);
+        if (!this.options.readonly) {
+            await this.octokit.issues.addAssignees({
+                ...this.params,
+                issue_number: this.issueData.number,
+                assignees: [assignee],
+            });
+        }
+    }
+    async removeAssignee(assignee) {
+        core_1.debug('Removing assignee ' + assignee + ' to ' + this.issueData.number);
+        if (!this.options.readonly) {
+            await this.octokit.issues.removeAssignees({
+                ...this.params,
+                issue_number: this.issueData.number,
+                assignees: [assignee],
+            });
+        }
+    }
+    async closeIssue() {
+        core_1.debug('Closing issue ' + this.issueData.number);
+        if (!this.options.readonly)
+            await this.octokit.issues.update({
+                ...this.params,
+                issue_number: this.issueData.number,
+                state: 'closed',
+            });
+    }
+    async reopenIssue() {
+        core_1.debug('Reopening issue ' + this.issueData.number);
+        if (!this.options.readonly)
+            await this.octokit.issues.update({
+                ...this.params,
+                issue_number: this.issueData.number,
+                state: 'open',
+            });
+    }
+    async lockIssue() {
+        core_1.debug('Locking issue ' + this.issueData.number);
+        if (!this.options.readonly)
+            await this.octokit.issues.lock({ ...this.params, issue_number: this.issueData.number });
+    }
+    async getIssue() {
+        if (isIssue(this.issueData)) {
+            core_1.debug('Got issue data from query result ' + this.issueData.number);
+            return this.issueData;
+        }
+        console.log('Fetching issue ' + this.issueData.number);
+        const issue = (await this.octokit.issues.get({
+            ...this.params,
+            issue_number: this.issueData.number,
+            mediaType: { previews: ['squirrel-girl'] },
+        })).data;
+        return (this.issueData = this.octokitIssueToIssue(issue));
+    }
+    async postComment(body) {
+        core_1.debug(`Posting comment ${body} on ${this.issueData.number}`);
+        if (!this.options.readonly)
+            await this.octokit.issues.createComment({
+                ...this.params,
+                issue_number: this.issueData.number,
+                body,
+            });
+    }
+    async deleteComment(id) {
+        core_1.debug(`Deleting comment ${id} on ${this.issueData.number}`);
+        if (!this.options.readonly)
+            await this.octokit.issues.deleteComment({
+                owner: this.params.owner,
+                repo: this.params.repo,
+                comment_id: id,
+            });
+    }
+    async setMilestone(milestoneId) {
+        core_1.debug(`Setting milestone for ${this.issueData.number} to ${milestoneId}`);
+        if (!this.options.readonly)
+            await this.octokit.issues.update({
+                ...this.params,
+                issue_number: this.issueData.number,
+                milestone: milestoneId,
+            });
+    }
+    async *getComments(last) {
+        core_1.debug('Fetching comments for ' + this.issueData.number);
+        const response = this.octokit.paginate.iterator(this.octokit.issues.listComments.endpoint.merge({
+            ...this.params,
+            issue_number: this.issueData.number,
+            per_page: 100,
+            ...(last ? { per_page: 1, page: (await this.getIssue()).numComments } : {}),
+        }));
+        for await (const page of response) {
+            numRequests++;
+            yield page.data.map((comment) => ({
+                author: { name: comment.user.login, isGitHubApp: comment.user.type === 'Bot' },
+                body: comment.body,
+                id: comment.id,
+                timestamp: +new Date(comment.created_at),
+            }));
+        }
+    }
+    async addLabel(name) {
+        core_1.debug(`Adding label ${name} to ${this.issueData.number}`);
+        if (!(await this.repoHasLabel(name))) {
+            throw Error(`Action could not execute becuase label ${name} is not defined.`);
+        }
+        if (!this.options.readonly)
+            await this.octokit.issues.addLabels({
+                ...this.params,
+                issue_number: this.issueData.number,
+                labels: [name],
+            });
+    }
+    async getAssigner(assignee) {
+        const options = this.octokit.issues.listEventsForTimeline.endpoint.merge({
+            ...this.params,
+            issue_number: this.issueData.number,
+        });
+        let assigner;
+        for await (const event of this.octokit.paginate.iterator(options)) {
+            numRequests++;
+            const timelineEvents = event.data;
+            for (const timelineEvent of timelineEvents) {
+                if (timelineEvent.event === 'assigned' &&
+                    timelineEvent.assignee.login === assignee) {
+                    assigner = timelineEvent.actor.login;
+                }
+            }
+        }
+        if (!assigner) {
+            throw Error('Expected to find ' + assignee + ' in issue timeline but did not.');
+        }
+        return assigner;
+    }
+    async removeLabel(name) {
+        core_1.debug(`Removing label ${name} from ${this.issueData.number}`);
+        try {
+            if (!this.options.readonly)
+                await this.octokit.issues.removeLabel({
+                    ...this.params,
+                    issue_number: this.issueData.number,
+                    name,
+                });
+        }
+        catch (err) {
+            if (err.status === 404) {
+                console.log(`Label ${name} not found on issue`);
+                return;
+            }
+            throw err;
+        }
+    }
+    async getClosingInfo(alreadyChecked = []) {
+        var _a, _b, _c, _d, _e, _f, _g;
+        if (alreadyChecked.includes(this.issueData.number)) {
+            return undefined;
+        }
+        alreadyChecked.push(this.issueData.number);
+        if ((await this.getIssue()).open) {
+            return;
+        }
+        const closingHashComment = /(?:\\|\/)closedWith (\S*)/;
+        const options = this.octokit.issues.listEventsForTimeline.endpoint.merge({
+            ...this.params,
+            issue_number: this.issueData.number,
+        });
+        let closingCommit;
+        const crossReferencing = [];
+        for await (const event of this.octokit.paginate.iterator(options)) {
+            numRequests++;
+            const timelineEvents = event.data;
+            for (const timelineEvent of timelineEvents) {
+                if ((timelineEvent.event === 'closed' || timelineEvent.event === 'merged') &&
+                    timelineEvent.commit_id &&
+                    timelineEvent.commit_url
+                        .toLowerCase()
+                        .includes(`/${this.params.owner}/${this.params.repo}/`.toLowerCase())) {
+                    closingCommit = {
+                        hash: timelineEvent.commit_id,
+                        timestamp: +new Date(timelineEvent.created_at),
+                    };
+                }
+                if (timelineEvent.event === 'reopened') {
+                    closingCommit = undefined;
+                }
+                if (timelineEvent.event === 'commented' &&
+                    !((_a = timelineEvent.body) === null || _a === void 0 ? void 0 : _a.includes('UNABLE_TO_LOCATE_COMMIT_MESSAGE')) &&
+                    closingHashComment.test(timelineEvent.body)) {
+                    closingCommit = {
+                        hash: closingHashComment.exec(timelineEvent.body)[1],
+                        timestamp: +new Date(timelineEvent.created_at),
+                    };
+                }
+                if (timelineEvent.event === 'cross-referenced' && ((_c = (_b = timelineEvent.source) === null || _b === void 0 ? void 0 : _b.issue) === null || _c === void 0 ? void 0 : _c.number) && ((_f = (_e = (_d = timelineEvent.source) === null || _d === void 0 ? void 0 : _d.issue) === null || _e === void 0 ? void 0 : _e.pull_request) === null || _f === void 0 ? void 0 : _f.url.includes(`/${this.params.owner}/${this.params.repo}/`.toLowerCase()))) {
+                    crossReferencing.push(timelineEvent.source.issue.number);
+                }
+            }
+        }
+        // If we dont have any closing info, try to get it from linked issues (PRs).
+        // If there's a linked issue that was closed at almost the same time, guess it was a PR that closed this.
+        if (!closingCommit) {
+            for (const id of crossReferencing.reverse()) {
+                const closed = await new OctoKitIssue(this.token, this.params, {
+                    number: id,
+                }, this.options).getClosingInfo(alreadyChecked);
+                if (closed) {
+                    if (Math.abs(closed.timestamp - ((_g = (await this.getIssue()).closedAt) !== null && _g !== void 0 ? _g : 0)) < 5000) {
+                        closingCommit = closed;
+                        break;
+                    }
+                }
+            }
+        }
+        console.log(`Got ${JSON.stringify(closingCommit)} as closing commit of ${this.issueData.number}`);
+        return closingCommit;
+    }
+}
+exports.OctoKitIssue = OctoKitIssue;
+function isIssue(object) {
+    const isIssue = 'author' in object &&
+        'body' in object &&
+        'title' in object &&
+        'labels' in object &&
+        'open' in object &&
+        'locked' in object &&
+        'number' in object &&
+        'numComments' in object &&
+        'reactions' in object &&
+        'milestoneId' in object;
+    return isIssue;
+}
+//# sourceMappingURL=octokit.js.map

.github/actions/api/octokit.ts

@@ -0,0 +1,470 @@
+/*---------------------------------------------------------------------------------------------
+ *  Copyright (c) Microsoft Corporation. All rights reserved.
+ *  Licensed under the MIT License. See LICENSE in the project root for license information.
+ *--------------------------------------------------------------------------------------------*/
+
+import { debug } from '@actions/core'
+import { GitHub as GitHubAPI } from '@actions/github'
+import { Octokit } from '@octokit/rest'
+import { exec } from 'child_process'
+import { Comment, GitHub, GitHubIssue, Issue, Query, User } from './api'
+
+let numRequests = 0
+export const getNumRequests = () => numRequests
+
+export class OctoKit implements GitHub {
+	private _octokit: GitHubAPI
+	protected get octokit(): GitHubAPI {
+		numRequests++
+		return this._octokit
+	}
+
+	// when in readonly mode, record labels just-created so at to not throw unneccesary errors
+	protected mockLabels: Set<string> = new Set()
+
+	constructor(
+		protected token: string,
+		protected params: { repo: string; owner: string },
+		protected options: { readonly: boolean } = { readonly: false },
+	) {
+		this._octokit = new GitHubAPI(token)
+	}
+
+	// TODO: just iterate over the issues in a page here instead of making caller do it
+	async *query(query: Query): AsyncIterableIterator<GitHubIssue[]> {
+		const q = query.q + ` repo:${this.params.owner}/${this.params.repo}`
+		console.log(`Querying for ${q}:`)
+
+		const options = this.octokit.search.issuesAndPullRequests.endpoint.merge({
+			...query,
+			q,
+			per_page: 100,
+			headers: { Accept: 'application/vnd.github.squirrel-girl-preview+json' },
+		})
+
+		let pageNum = 0
+
+		const timeout = async () => {
+			if (pageNum < 2) {
+				/* pass */
+			} else if (pageNum < 4) {
+				await new Promise((resolve) => setTimeout(resolve, 3000))
+			} else {
+				await new Promise((resolve) => setTimeout(resolve, 30000))
+			}
+		}
+
+		for await (const pageResponse of this.octokit.paginate.iterator(options)) {
+			await timeout()
+			numRequests++
+			const page: Array<Octokit.SearchIssuesAndPullRequestsResponseItemsItem> = pageResponse.data
+			console.log(`Page ${++pageNum}: ${page.map(({ number }) => number).join(' ')}`)
+			yield page.map(
+				(issue) => new OctoKitIssue(this.token, this.params, this.octokitIssueToIssue(issue), this.options),
+			)
+		}
+	}
+
+	async createIssue(owner: string, repo: string, title: string, body: string): Promise<void> {
+		debug(`Creating issue \`${title}\` on ${owner}/${repo}`)
+		if (!this.options.readonly) await this.octokit.issues.create({ owner, repo, title, body })
+	}
+
+	protected octokitIssueToIssue(
+		issue: Octokit.IssuesGetResponse | Octokit.SearchIssuesAndPullRequestsResponseItemsItem,
+	): Issue {
+		return {
+			author: { name: issue.user.login, isGitHubApp: issue.user.type === 'Bot' },
+			body: issue.body,
+			number: issue.number,
+			title: issue.title,
+			labels: (issue.labels as Octokit.IssuesGetLabelResponse[]).map((label) => label.name),
+			open: issue.state === 'open',
+			locked: (issue as any).locked,
+			numComments: issue.comments,
+			reactions: (issue as any).reactions,
+			assignee: issue.assignee?.login ?? (issue as any).assignees?.[0]?.login,
+			milestoneId: issue.milestone?.number ?? null,
+			createdAt: +new Date(issue.created_at),
+			updatedAt: +new Date(issue.updated_at),
+			closedAt: issue.closed_at ? +new Date((issue.closed_at as unknown) as string) : undefined,
+		}
+	}
+
+	private writeAccessCache: Record<string, boolean> = {}
+	async hasWriteAccess(user: User): Promise<boolean> {
+		if (user.name in this.writeAccessCache) {
+			debug('Got permissions from cache for ' + user)
+			return this.writeAccessCache[user.name]
+		}
+		debug('Fetching permissions for ' + user)
+		const permissions = (
+			await this.octokit.repos.getCollaboratorPermissionLevel({
+				...this.params,
+				username: user.name,
+			})
+		).data.permission
+		return (this.writeAccessCache[user.name] = permissions === 'admin' || permissions === 'write')
+	}
+
+	async repoHasLabel(name: string): Promise<boolean> {
+		try {
+			await this.octokit.issues.getLabel({ ...this.params, name })
+			return true
+		} catch (err) {
+			if (err.status === 404) {
+				return this.options.readonly && this.mockLabels.has(name)
+			}
+			throw err
+		}
+	}
+
+	async createLabel(name: string, color: string, description: string): Promise<void> {
+		debug('Creating label ' + name)
+		if (!this.options.readonly)
+			await this.octokit.issues.createLabel({ ...this.params, color, description, name })
+		else this.mockLabels.add(name)
+	}
+
+	async deleteLabel(name: string): Promise<void> {
+		debug('Deleting label ' + name)
+		try {
+			if (!this.options.readonly) await this.octokit.issues.deleteLabel({ ...this.params, name })
+		} catch (err) {
+			if (err.status === 404) {
+				return
+			}
+			throw err
+		}
+	}
+
+	async readConfig(path: string): Promise<any> {
+		debug('Reading config at ' + path)
+		const repoPath = `.github/${path}.json`
+		try {
+			const data = (await this.octokit.repos.getContents({ ...this.params, path: repoPath })).data
+
+			if ('type' in data && data.type === 'file') {
+				if (data.encoding === 'base64' && data.content) {
+					return JSON.parse(Buffer.from(data.content, 'base64').toString('utf-8'))
+				}
+				throw Error(`Could not read contents "${data.content}" in encoding "${data.encoding}"`)
+			}
+			throw Error('Found directory at config path when expecting file' + JSON.stringify(data))
+		} catch (e) {
+			throw Error('Error with config file at ' + repoPath + ': ' + JSON.stringify(e))
+		}
+	}
+
+	async releaseContainsCommit(release: string, commit: string): Promise<'yes' | 'no' | 'unknown'> {
+		return new Promise((resolve, reject) =>
+			exec(`git -C ./repo merge-base --is-ancestor ${commit} ${release}`, (err) => {
+				if (!err || err.code === 1) {
+					resolve(!err ? 'yes' : 'no')
+				} else if (err.message.includes(`Not a valid commit name ${release}`)) {
+					// release branch is forked. Probably in endgame. Not released.
+					resolve('no')
+				} else if (err.message.includes(`Not a valid commit name ${commit}`)) {
+					// commit is probably in a different repo.
+					resolve('unknown')
+				} else {
+					reject(err)
+				}
+			}),
+		)
+	}
+
+	async dispatch(title: string): Promise<void> {
+		debug('Dispatching ' + title)
+		if (!this.options.readonly)
+			await this.octokit.repos.createDispatchEvent({ ...this.params, event_type: title })
+	}
+}
+
+export class OctoKitIssue extends OctoKit implements GitHubIssue {
+	constructor(
+		token: string,
+		protected params: { repo: string; owner: string },
+		private issueData: { number: number } | Issue,
+		options: { readonly: boolean } = { readonly: false },
+	) {
+		super(token, params, options)
+		console.log('running bot on issue', issueData.number)
+	}
+
+	async addAssignee(assignee: string): Promise<void> {
+		debug('Adding assignee ' + assignee + ' to ' + this.issueData.number)
+		if (!this.options.readonly) {
+			await this.octokit.issues.addAssignees({
+				...this.params,
+				issue_number: this.issueData.number,
+				assignees: [assignee],
+			})
+		}
+	}
+
+	async removeAssignee(assignee: string): Promise<void> {
+		debug('Removing assignee ' + assignee + ' to ' + this.issueData.number)
+		if (!this.options.readonly) {
+			await this.octokit.issues.removeAssignees({
+				...this.params,
+				issue_number: this.issueData.number,
+				assignees: [assignee],
+			})
+		}
+	}
+
+	async closeIssue(): Promise<void> {
+		debug('Closing issue ' + this.issueData.number)
+		if (!this.options.readonly)
+			await this.octokit.issues.update({
+				...this.params,
+				issue_number: this.issueData.number,
+				state: 'closed',
+			})
+	}
+
+	async reopenIssue(): Promise<void> {
+		debug('Reopening issue ' + this.issueData.number)
+		if (!this.options.readonly)
+			await this.octokit.issues.update({
+				...this.params,
+				issue_number: this.issueData.number,
+				state: 'open',
+			})
+	}
+
+	async lockIssue(): Promise<void> {
+		debug('Locking issue ' + this.issueData.number)
+		if (!this.options.readonly)
+			await this.octokit.issues.lock({ ...this.params, issue_number: this.issueData.number })
+	}
+
+	async getIssue(): Promise<Issue> {
+		if (isIssue(this.issueData)) {
+			debug('Got issue data from query result ' + this.issueData.number)
+			return this.issueData
+		}
+
+		console.log('Fetching issue ' + this.issueData.number)
+		const issue = (
+			await this.octokit.issues.get({
+				...this.params,
+				issue_number: this.issueData.number,
+				mediaType: { previews: ['squirrel-girl'] },
+			})
+		).data
+		return (this.issueData = this.octokitIssueToIssue(issue))
+	}
+
+	async postComment(body: string): Promise<void> {
+		debug(`Posting comment ${body} on ${this.issueData.number}`)
+		if (!this.options.readonly)
+			await this.octokit.issues.createComment({
+				...this.params,
+				issue_number: this.issueData.number,
+				body,
+			})
+	}
+
+	async deleteComment(id: number): Promise<void> {
+		debug(`Deleting comment ${id} on ${this.issueData.number}`)
+		if (!this.options.readonly)
+			await this.octokit.issues.deleteComment({
+				owner: this.params.owner,
+				repo: this.params.repo,
+				comment_id: id,
+			})
+	}
+
+	async setMilestone(milestoneId: number) {
+		debug(`Setting milestone for ${this.issueData.number} to ${milestoneId}`)
+		if (!this.options.readonly)
+			await this.octokit.issues.update({
+				...this.params,
+				issue_number: this.issueData.number,
+				milestone: milestoneId,
+			})
+	}
+
+	async *getComments(last?: boolean): AsyncIterableIterator<Comment[]> {
+		debug('Fetching comments for ' + this.issueData.number)
+
+		const response = this.octokit.paginate.iterator(
+			this.octokit.issues.listComments.endpoint.merge({
+				...this.params,
+				issue_number: this.issueData.number,
+				per_page: 100,
+				...(last ? { per_page: 1, page: (await this.getIssue()).numComments } : {}),
+			}),
+		)
+
+		for await (const page of response) {
+			numRequests++
+			yield (page.data as Octokit.IssuesListCommentsResponseItem[]).map((comment) => ({
+				author: { name: comment.user.login, isGitHubApp: comment.user.type === 'Bot' },
+				body: comment.body,
+				id: comment.id,
+				timestamp: +new Date(comment.created_at),
+			}))
+		}
+	}
+
+	async addLabel(name: string): Promise<void> {
+		debug(`Adding label ${name} to ${this.issueData.number}`)
+		if (!(await this.repoHasLabel(name))) {
+			throw Error(`Action could not execute becuase label ${name} is not defined.`)
+		}
+		if (!this.options.readonly)
+			await this.octokit.issues.addLabels({
+				...this.params,
+				issue_number: this.issueData.number,
+				labels: [name],
+			})
+	}
+
+	async getAssigner(assignee: string): Promise<string> {
+		const options = this.octokit.issues.listEventsForTimeline.endpoint.merge({
+			...this.params,
+			issue_number: this.issueData.number,
+		})
+
+		let assigner: string | undefined
+
+		for await (const event of this.octokit.paginate.iterator(options)) {
+			numRequests++
+			const timelineEvents = event.data as Octokit.IssuesListEventsForTimelineResponseItem[]
+			for (const timelineEvent of timelineEvents) {
+				if (
+					timelineEvent.event === 'assigned' &&
+					(timelineEvent as any).assignee.login === assignee
+				) {
+					assigner = timelineEvent.actor.login
+				}
+			}
+		}
+
+		if (!assigner) {
+			throw Error('Expected to find ' + assignee + ' in issue timeline but did not.')
+		}
+
+		return assigner
+	}
+
+	async removeLabel(name: string): Promise<void> {
+		debug(`Removing label ${name} from ${this.issueData.number}`)
+		try {
+			if (!this.options.readonly)
+				await this.octokit.issues.removeLabel({
+					...this.params,
+					issue_number: this.issueData.number,
+					name,
+				})
+		} catch (err) {
+			if (err.status === 404) {
+				console.log(`Label ${name} not found on issue`)
+				return
+			}
+			throw err
+		}
+	}
+
+	async getClosingInfo(
+		alreadyChecked: number[] = [],
+	): Promise<{ hash: string | undefined; timestamp: number } | undefined> {
+		if (alreadyChecked.includes(this.issueData.number)) {
+			return undefined
+		}
+		alreadyChecked.push(this.issueData.number)
+
+		if ((await this.getIssue()).open) {
+			return
+		}
+
+		const closingHashComment = /(?:\\|\/)closedWith (\S*)/
+
+		const options = this.octokit.issues.listEventsForTimeline.endpoint.merge({
+			...this.params,
+			issue_number: this.issueData.number,
+		})
+		let closingCommit: { hash: string | undefined; timestamp: number } | undefined
+		const crossReferencing: number[] = []
+		for await (const event of this.octokit.paginate.iterator(options)) {
+			numRequests++
+
+			const timelineEvents = event.data as Octokit.IssuesListEventsForTimelineResponseItem[]
+			for (const timelineEvent of timelineEvents) {
+				if (
+					(timelineEvent.event === 'closed' || timelineEvent.event === 'merged') &&
+					timelineEvent.commit_id &&
+					timelineEvent.commit_url
+						.toLowerCase()
+						.includes(`/${this.params.owner}/${this.params.repo}/`.toLowerCase())
+				) {
+					closingCommit = {
+						hash: timelineEvent.commit_id,
+						timestamp: +new Date(timelineEvent.created_at),
+					}
+				}
+				if (timelineEvent.event === 'reopened') {
+					closingCommit = undefined
+				}
+				if (
+					timelineEvent.event === 'commented' &&
+					!((timelineEvent as any).body as string)?.includes('UNABLE_TO_LOCATE_COMMIT_MESSAGE') &&
+					closingHashComment.test((timelineEvent as any).body)
+				) {
+					closingCommit = {
+						hash: closingHashComment.exec((timelineEvent as any).body)![1],
+						timestamp: +new Date(timelineEvent.created_at),
+					}
+				}
+				if (
+					timelineEvent.event === 'cross-referenced' &&
+					(timelineEvent as any).source?.issue?.number &&
+					(timelineEvent as any).source?.issue?.pull_request?.url.includes(
+						`/${this.params.owner}/${this.params.repo}/`.toLowerCase(),
+					)
+				) {
+					crossReferencing.push((timelineEvent as any).source.issue.number)
+				}
+			}
+		}
+
+		// If we dont have any closing info, try to get it from linked issues (PRs).
+		// If there's a linked issue that was closed at almost the same time, guess it was a PR that closed this.
+		if (!closingCommit) {
+			for (const id of crossReferencing.reverse()) {
+				const closed = await new OctoKitIssue(this.token, this.params, {
+					number: id,
+				}, this.options).getClosingInfo(alreadyChecked)
+
+				if (closed) {
+					if (Math.abs(closed.timestamp - ((await this.getIssue()).closedAt ?? 0)) < 5000) {
+						closingCommit = closed
+						break
+					}
+				}
+			}
+		}
+
+		console.log(`Got ${JSON.stringify(closingCommit)} as closing commit of ${this.issueData.number}`)
+		return closingCommit
+	}
+}
+
+function isIssue(object: any): object is Issue {
+	const isIssue =
+		'author' in object &&
+		'body' in object &&
+		'title' in object &&
+		'labels' in object &&
+		'open' in object &&
+		'locked' in object &&
+		'number' in object &&
+		'numComments' in object &&
+		'reactions' in object &&
+		'milestoneId' in object
+
+	return isIssue
+}

.github/actions/common/Action.js

@@ -0,0 +1,129 @@
+"use strict";
+/*---------------------------------------------------------------------------------------------
+ *  Copyright (c) Microsoft Corporation. All rights reserved.
+ *  Licensed under the MIT License. See LICENSE in the project root for license information.
+ *--------------------------------------------------------------------------------------------*/
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.Action = void 0;
+const octokit_1 = require("../api/octokit");
+const github_1 = require("@actions/github");
+const utils_1 = require("./utils");
+const core_1 = require("@actions/core");
+class Action {
+    constructor() {
+        this.token = utils_1.getRequiredInput('token');
+        this.username = new github_1.GitHub(this.token).users.getAuthenticated().then((v) => v.data.name);
+    }
+    async run() {
+        var _a, _b, _c, _d, _e, _f, _g, _h, _j, _k, _l, _m, _o;
+        console.log('running ', this.id, 'with context', {
+            ...github_1.context,
+            payload: {
+                issue: (_b = (_a = github_1.context.payload) === null || _a === void 0 ? void 0 : _a.issue) === null || _b === void 0 ? void 0 : _b.number,
+                label: (_d = (_c = github_1.context.payload) === null || _c === void 0 ? void 0 : _c.label) === null || _d === void 0 ? void 0 : _d.name,
+                repository: (_f = (_e = github_1.context.payload) === null || _e === void 0 ? void 0 : _e.repository) === null || _f === void 0 ? void 0 : _f.html_url,
+                sender: (_j = (_h = (_g = github_1.context.payload) === null || _g === void 0 ? void 0 : _g.sender) === null || _h === void 0 ? void 0 : _h.login) !== null && _j !== void 0 ? _j : (_l = (_k = github_1.context.payload) === null || _k === void 0 ? void 0 : _k.sender) === null || _l === void 0 ? void 0 : _l.type,
+            },
+        });
+        if (utils_1.errorLoggingIssue) {
+            const { repo, issue, owner } = utils_1.errorLoggingIssue;
+            if (github_1.context.repo.repo === repo &&
+                github_1.context.repo.owner === owner &&
+                ((_m = github_1.context.payload.issue) === null || _m === void 0 ? void 0 : _m.number) === issue) {
+                return console.log('refusing to run on error logging issue to prevent cascading errors');
+            }
+        }
+        try {
+            const token = utils_1.getRequiredInput('token');
+            const readonly = !!core_1.getInput('readonly');
+            const issue = (_o = github_1.context === null || github_1.context === void 0 ? void 0 : github_1.context.issue) === null || _o === void 0 ? void 0 : _o.number;
+            if (issue) {
+                const octokit = new octokit_1.OctoKitIssue(token, github_1.context.repo, { number: issue }, { readonly });
+                if (github_1.context.eventName === 'issue_comment') {
+                    await this.onCommented(octokit, github_1.context.payload.comment.body, github_1.context.actor);
+                }
+                else if (github_1.context.eventName === 'issues') {
+                    switch (github_1.context.payload.action) {
+                        case 'opened':
+                            await this.onOpened(octokit);
+                            break;
+                        case 'reopened':
+                            await this.onReopened(octokit);
+                            break;
+                        case 'closed':
+                            await this.onClosed(octokit);
+                            break;
+                        case 'labeled':
+                            await this.onLabeled(octokit, github_1.context.payload.label.name);
+                            break;
+                        case 'unassigned':
+                            await this.onUnassigned(octokit, github_1.context.payload.assignee.login);
+                            break;
+                        case 'edited':
+                            await this.onEdited(octokit);
+                            break;
+                        case 'milestoned':
+                            await this.onMilestoned(octokit);
+                            break;
+                        default:
+                            throw Error('Unexpected action: ' + github_1.context.payload.action);
+                    }
+                }
+            }
+            else {
+                await this.onTriggered(new octokit_1.OctoKit(token, github_1.context.repo, { readonly }));
+            }
+        }
+        catch (e) {
+            await this.error(e);
+        }
+        const usage = await utils_1.getRateLimit(this.token);
+    }
+    async error(error) {
+        const details = {
+            message: `${error.message}\n${error.stack}`,
+            id: this.id,
+            user: await this.username,
+        };
+        if (github_1.context.issue.number)
+            details.issue = github_1.context.issue.number;
+        const rendered = `
+Message: ${details.message}
+
+Actor: ${details.user}
+
+ID: ${details.id}
+`;
+        await utils_1.logErrorToIssue(rendered, true, this.token);
+        core_1.setFailed(error.message);
+    }
+    async onTriggered(_octokit) {
+        throw Error('not implemented');
+    }
+    async onEdited(_issue) {
+        throw Error('not implemented');
+    }
+    async onLabeled(_issue, _label) {
+        throw Error('not implemented');
+    }
+    async onUnassigned(_issue, _label) {
+        throw Error('not implemented');
+    }
+    async onOpened(_issue) {
+        throw Error('not implemented');
+    }
+    async onReopened(_issue) {
+        throw Error('not implemented');
+    }
+    async onClosed(_issue) {
+        throw Error('not implemented');
+    }
+    async onMilestoned(_issue) {
+        throw Error('not implemented');
+    }
+    async onCommented(_issue, _comment, _actor) {
+        throw Error('not implemented');
+    }
+}
+exports.Action = Action;
+//# sourceMappingURL=Action.js.map

.github/actions/common/Action.ts

@@ -0,0 +1,137 @@
+/*---------------------------------------------------------------------------------------------
+ *  Copyright (c) Microsoft Corporation. All rights reserved.
+ *  Licensed under the MIT License. See LICENSE in the project root for license information.
+ *--------------------------------------------------------------------------------------------*/
+
+import { OctoKit, OctoKitIssue, getNumRequests } from '../api/octokit'
+import { context, GitHub } from '@actions/github'
+import { getRequiredInput, logErrorToIssue, getRateLimit, errorLoggingIssue } from './utils'
+import { getInput, setFailed } from '@actions/core'
+
+export abstract class Action {
+	abstract id: string
+
+	private username: Promise<string>
+	private token = getRequiredInput('token')
+
+	constructor() {
+		this.username = new GitHub(this.token).users.getAuthenticated().then((v) => v.data.name)
+	}
+
+	public async run() {
+		console.log('running ', this.id, 'with context', {
+			...context,
+			payload: {
+				issue: context.payload?.issue?.number,
+				label: context.payload?.label?.name,
+				repository: context.payload?.repository?.html_url,
+				sender: context.payload?.sender?.login ?? context.payload?.sender?.type,
+			},
+		})
+
+		if (errorLoggingIssue) {
+			const { repo, issue, owner } = errorLoggingIssue
+			if (
+				context.repo.repo === repo &&
+				context.repo.owner === owner &&
+				context.payload.issue?.number === issue
+			) {
+				return console.log('refusing to run on error logging issue to prevent cascading errors')
+			}
+		}
+
+		try {
+			const token = getRequiredInput('token')
+			const readonly = !!getInput('readonly')
+
+			const issue = context?.issue?.number
+			if (issue) {
+				const octokit = new OctoKitIssue(token, context.repo, { number: issue }, { readonly })
+				if (context.eventName === 'issue_comment') {
+					await this.onCommented(octokit, context.payload.comment.body, context.actor)
+				} else if (context.eventName === 'issues') {
+					switch (context.payload.action) {
+						case 'opened':
+							await this.onOpened(octokit)
+							break
+						case 'reopened':
+							await this.onReopened(octokit)
+							break
+						case 'closed':
+							await this.onClosed(octokit)
+							break
+						case 'labeled':
+							await this.onLabeled(octokit, context.payload.label.name)
+							break
+						case 'unassigned':
+							await this.onUnassigned(octokit, context.payload.assignee.login)
+							break
+						case 'edited':
+							await this.onEdited(octokit)
+							break
+						case 'milestoned':
+							await this.onMilestoned(octokit)
+							break
+						default:
+							throw Error('Unexpected action: ' + context.payload.action)
+					}
+				}
+			} else {
+				await this.onTriggered(new OctoKit(token, context.repo, { readonly }))
+			}
+		} catch (e) {
+			await this.error(e)
+		}
+
+		const usage = await getRateLimit(this.token)
+	}
+
+	private async error(error: Error) {
+		const details: any = {
+			message: `${error.message}\n${error.stack}`,
+			id: this.id,
+			user: await this.username,
+		}
+
+		if (context.issue.number) details.issue = context.issue.number
+
+		const rendered = `
+Message: ${details.message}
+
+Actor: ${details.user}
+
+ID: ${details.id}
+`
+		await logErrorToIssue(rendered, true, this.token)
+
+		setFailed(error.message)
+	}
+
+	protected async onTriggered(_octokit: OctoKit): Promise<void> {
+		throw Error('not implemented')
+	}
+	protected async onEdited(_issue: OctoKitIssue): Promise<void> {
+		throw Error('not implemented')
+	}
+	protected async onLabeled(_issue: OctoKitIssue, _label: string): Promise<void> {
+		throw Error('not implemented')
+	}
+	protected async onUnassigned(_issue: OctoKitIssue, _label: string): Promise<void> {
+		throw Error('not implemented')
+	}
+	protected async onOpened(_issue: OctoKitIssue): Promise<void> {
+		throw Error('not implemented')
+	}
+	protected async onReopened(_issue: OctoKitIssue): Promise<void> {
+		throw Error('not implemented')
+	}
+	protected async onClosed(_issue: OctoKitIssue): Promise<void> {
+		throw Error('not implemented')
+	}
+	protected async onMilestoned(_issue: OctoKitIssue): Promise<void> {
+		throw Error('not implemented')
+	}
+	protected async onCommented(_issue: OctoKitIssue, _comment: string, _actor: string): Promise<void> {
+		throw Error('not implemented')
+	}
+}

.github/actions/common/ActionBase.js

@@ -0,0 +1,181 @@
+"use strict";
+/*---------------------------------------------------------------------------------------------
+ *  Copyright (c) Microsoft Corporation. All rights reserved.
+ *  Licensed under the MIT License. See LICENSE in the project root for license information.
+ *--------------------------------------------------------------------------------------------*/
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ActionBase = void 0;
+class ActionBase {
+    constructor(labels, milestoneName, milestoneId, ignoreLabels, ignoreMilestoneNames, ignoreMilestoneIds, minimumVotes, maximumVotes, involves) {
+        this.labels = labels;
+        this.milestoneName = milestoneName;
+        this.milestoneId = milestoneId;
+        this.ignoreLabels = ignoreLabels;
+        this.ignoreMilestoneNames = ignoreMilestoneNames;
+        this.ignoreMilestoneIds = ignoreMilestoneIds;
+        this.minimumVotes = minimumVotes;
+        this.maximumVotes = maximumVotes;
+        this.involves = involves;
+        this.labelsSet = [];
+        this.ignoreLabelsSet = [];
+        this.ignoreMilestoneNamesSet = [];
+        this.ignoreMilestoneIdsSet = [];
+        this.ignoreAllWithLabels = false;
+        this.ignoreAllWithMilestones = false;
+        this.involvesSet = [];
+    }
+    buildQuery(baseQuery) {
+        var _a, _b, _c, _d, _e, _f;
+        let query = baseQuery;
+        console.log(`labels: ${this.labels}`);
+        console.log(`milestoneName: ${this.milestoneName}`);
+        console.log(`milestoneId: ${this.milestoneId}`);
+        console.log(`ignoreLabels: ${this.ignoreLabels}`);
+        console.log(`ignoreMilestoneNames: ${this.ignoreMilestoneNames}`);
+        console.log(`ignoreMilestoneIds: ${this.ignoreMilestoneIds}`);
+        console.log(`minimumVotes: ${this.minimumVotes}`);
+        console.log(`maximumVotes: ${this.maximumVotes}`);
+        console.log(`involves: ${this.involves}`);
+        // Both milestone name and milestone Id must be provided and must match.
+        // The name is used to construct the query, which does not accept ID.
+        // The ID is used for comparisons with issue data, which does not include the name.
+        // TODO: Figure out a way to convert either from milestone name to ID, or vice versa.
+        // If label inclusion and exclusion are mixed, exclusion will take precedence.
+        // For example, an issue with both labels A and B will not match if B is excluded, even if A is included.
+        // If a milestoneName/milestoneId are set, ignoreMilenameName/ignoreMilestoneIds are ignored.
+        // GitHub does not appear to support searching for all issues with milestones (not lacking a milestone).  "-no:milestone" does not work.
+        // GitHub does not appear to support searching for all issues with labels (not lacking a label).  "-no:label" does not work.
+        // All indicated labels must be present
+        if (this.labels) {
+            if (((_a = this.labels) === null || _a === void 0 ? void 0 : _a.length) > 2 && ((_b = this.labels) === null || _b === void 0 ? void 0 : _b.startsWith('"')) && ((_c = this.labels) === null || _c === void 0 ? void 0 : _c.endsWith('"'))) {
+                this.labels = this.labels.substring(1, this.labels.length - 2);
+            }
+            this.labelsSet = (_d = this.labels) === null || _d === void 0 ? void 0 : _d.split(',');
+            for (const str of this.labelsSet) {
+                if (str != "") {
+                    query = query.concat(` label:"${str}"`);
+                }
+            }
+        }
+        // The "involves" qualifier to find issues that in some way involve a certain user.
+        // It is a logical OR between the author, assignee, and mentions.
+        if (this.involves) {
+            this.involvesSet = (_e = this.involves) === null || _e === void 0 ? void 0 : _e.split(',');
+            for (const str of this.involvesSet) {
+                if (str != "") {
+                    query = query.concat(` involves:"${str}"`);
+                }
+            }
+        }
+        if (this.ignoreLabels) {
+            if (this.ignoreLabels == "*" && !this.labels) { // only if unlabeled
+                query = query.concat(` no:label`);
+                this.ignoreAllWithLabels = true;
+            }
+            else {
+                this.ignoreLabelsSet = (_f = this.ignoreLabels) === null || _f === void 0 ? void 0 : _f.split(',');
+                for (const str of this.ignoreLabelsSet) {
+                    if (str != "") {
+                        query = query.concat(` -label:"${str}"`);
+                    }
+                }
+            }
+        }
+        if (this.milestoneName) {
+            query = query.concat(` milestone:"${this.milestoneName}"`);
+        }
+        else if (this.ignoreMilestoneNames) {
+            if (this.ignoreMilestoneNames == "*") {
+                query = query.concat(` no:milestone`);
+                this.ignoreAllWithMilestones = true;
+            }
+            else if (this.ignoreMilestoneIds) {
+                this.ignoreMilestoneNamesSet = this.ignoreMilestoneNames.split(',');
+                this.ignoreMilestoneIdsSet = this.ignoreMilestoneIds.split(',');
+                for (const str of this.ignoreMilestoneNamesSet) {
+                    if (str != "") {
+                        query = query.concat(` -milestone:"${str}"`);
+                    }
+                }
+            }
+        }
+        return query;
+    }
+    // This is necessary because GitHub sometimes returns incorrect results,
+    // and because issues may get modified while we are processing them.
+    validateIssue(issue) {
+        if (this.ignoreAllWithLabels) {
+            // Validate that the issue does not have labels
+            if (issue.labels && issue.labels.length !== 0) {
+                console.log(`Issue ${issue.number} skipped due to label found after querying for no:label.`);
+                return false;
+            }
+        }
+        else {
+            // Make sure all labels we wanted are present.
+            if ((!issue.labels || issue.labels.length == 0) && this.labelsSet.length > 0) {
+                console.log(`Issue ${issue.number} skipped due to not having a required label set.  No labels found.`);
+                return false;
+            }
+            for (const str of this.labelsSet) {
+                if (!issue.labels.includes(str)) {
+                    console.log(`Issue ${issue.number} skipped due to not having a required label set.`);
+                    return false;
+                }
+            }
+            // Make sure no labels we wanted to ignore are present.
+            if (issue.labels && issue.labels.length > 0) {
+                for (const str of this.ignoreLabelsSet) {
+                    if (issue.labels.includes(str)) {
+                        console.log(`Issue ${issue.number} skipped due to having an ignore label set: ${str}`);
+                        return false;
+                    }
+                }
+            }
+        }
+        if (this.ignoreAllWithMilestones) {
+            // Validate that the issue does not have a milestone.
+            if (issue.milestoneId != null) {
+                console.log(`Issue ${issue.number} skipped due to milestone found after querying for no:milestone.`);
+                return false;
+            }
+        }
+        else {
+            // Make sure milestone is present, if required.
+            if (this.milestoneId != undefined && issue.milestoneId != +this.milestoneId) {
+                console.log(`Issue ${issue.number} skipped due to not having required milsetone id ${this.milestoneId}.  Had: ${issue.milestoneId}`);
+                return false;
+            }
+            // Make sure a milestones we wanted to ignore is not present.
+            if (issue.milestoneId != null) {
+                for (const str of this.ignoreMilestoneIdsSet) {
+                    if (issue.milestoneId == +str) {
+                        console.log(`Issue ${issue.number} skipped due to milestone ${issue.milestoneId} found in list of ignored milestone IDs.`);
+                        return false;
+                    }
+                }
+            }
+        }
+        // Verify the issue has a sufficient number of upvotes
+        let upvotes = 0;
+        if (issue.reactions) {
+            upvotes = issue.reactions['+1'];
+        }
+        if (this.minimumVotes != undefined) {
+            if (upvotes < this.minimumVotes) {
+                console.log(`Issue ${issue.number} skipped due to not having at least ${this.minimumVotes} upvotes.  Had: ${upvotes}`);
+                return false;
+            }
+        }
+        // Verify the issue does not have too many upvotes
+        if (this.maximumVotes != undefined) {
+            if (upvotes > this.maximumVotes) {
+                console.log(`Issue ${issue.number} skipped due to having more than ${this.maximumVotes} upvotes.  Had: ${upvotes}`);
+                return false;
+            }
+        }
+        return true;
+    }
+}
+exports.ActionBase = ActionBase;
+//# sourceMappingURL=ActionBase.js.map

.github/actions/common/ActionBase.ts

@@ -0,0 +1,187 @@
+/*---------------------------------------------------------------------------------------------
+ *  Copyright (c) Microsoft Corporation. All rights reserved.
+ *  Licensed under the MIT License. See LICENSE in the project root for license information.
+ *--------------------------------------------------------------------------------------------*/
+
+import { Issue } from '../api/api'
+
+export class ActionBase {
+	constructor(
+		private labels?: string,
+		private milestoneName?: string,
+		private milestoneId?: string,
+		private ignoreLabels?: string,
+		private ignoreMilestoneNames?: string,
+		private ignoreMilestoneIds?: string,
+		private minimumVotes?: number,
+		private maximumVotes?: number,
+		private involves?: string,
+	) {}
+
+	private labelsSet: string[] = [];
+	private ignoreLabelsSet: string[] = [];
+	private ignoreMilestoneNamesSet: string[] = [];
+	private ignoreMilestoneIdsSet: string[] = [];
+	private ignoreAllWithLabels: boolean = false;
+	private ignoreAllWithMilestones: boolean = false;
+	private involvesSet: string[] = [];
+
+	buildQuery(baseQuery: string): string {
+		let query = baseQuery;
+
+		console.log(`labels: ${this.labels}`);
+		console.log(`milestoneName: ${this.milestoneName}`);
+		console.log(`milestoneId: ${this.milestoneId}`);
+		console.log(`ignoreLabels: ${this.ignoreLabels}`);
+		console.log(`ignoreMilestoneNames: ${this.ignoreMilestoneNames}`);
+		console.log(`ignoreMilestoneIds: ${this.ignoreMilestoneIds}`);
+		console.log(`minimumVotes: ${this.minimumVotes}`);
+		console.log(`maximumVotes: ${this.maximumVotes}`);
+		console.log(`involves: ${this.involves}`);
+
+		// Both milestone name and milestone Id must be provided and must match.
+		// The name is used to construct the query, which does not accept ID.
+		// The ID is used for comparisons with issue data, which does not include the name.
+		// TODO: Figure out a way to convert either from milestone name to ID, or vice versa.
+
+		// If label inclusion and exclusion are mixed, exclusion will take precedence.
+		// For example, an issue with both labels A and B will not match if B is excluded, even if A is included.
+
+		// If a milestoneName/milestoneId are set, ignoreMilenameName/ignoreMilestoneIds are ignored.
+
+		// GitHub does not appear to support searching for all issues with milestones (not lacking a milestone).  "-no:milestone" does not work.
+		// GitHub does not appear to support searching for all issues with labels (not lacking a label).  "-no:label" does not work.
+
+		// All indicated labels must be present
+		if (this.labels) {
+			if (this.labels?.length > 2  && this.labels?.startsWith('"') && this.labels?.endsWith('"')) {
+				this.labels = this.labels.substring(1, this.labels.length - 2);
+			}
+			this.labelsSet = this.labels?.split(',');
+			for (const str of this.labelsSet) {
+				if (str != "") {
+					query = query.concat(` label:"${str}"`);
+				}
+			}
+		}
+
+		// The "involves" qualifier to find issues that in some way involve a certain user.
+		// It is a logical OR between the author, assignee, and mentions.
+		if (this.involves) {
+			this.involvesSet = this.involves?.split(',');
+			for (const str of this.involvesSet) {
+				if (str != "") {
+					query = query.concat(` involves:"${str}"`)
+				}
+			}
+		}
+
+		if (this.ignoreLabels) {
+			if (this.ignoreLabels == "*" && !this.labels) { // only if unlabeled
+				query = query.concat(` no:label`)
+				this.ignoreAllWithLabels = true;
+			} else {
+				this.ignoreLabelsSet = this.ignoreLabels?.split(',');
+				for (const str of this.ignoreLabelsSet) {
+					if (str != "") {
+						query = query.concat(` -label:"${str}"`)
+					}
+				}
+			}
+		}
+
+		if (this.milestoneName) {
+			query = query.concat(` milestone:"${this.milestoneName}"`)
+		}
+		else if (this.ignoreMilestoneNames) {
+			if (this.ignoreMilestoneNames == "*") {
+				query = query.concat(` no:milestone`)
+				this.ignoreAllWithMilestones = true;
+			} else if (this.ignoreMilestoneIds) {
+				this.ignoreMilestoneNamesSet = this.ignoreMilestoneNames.split(',');
+				this.ignoreMilestoneIdsSet = this.ignoreMilestoneIds.split(',');
+				for (const str of this.ignoreMilestoneNamesSet) {
+					if (str != "") {
+						query = query.concat(` -milestone:"${str}"`)
+					}
+				}
+			}
+		}
+
+		return query;
+	}
+
+	// This is necessary because GitHub sometimes returns incorrect results,
+	// and because issues may get modified while we are processing them.
+	validateIssue(issue: Issue): boolean {
+		if (this.ignoreAllWithLabels) {
+			// Validate that the issue does not have labels
+			if (issue.labels && issue.labels.length !== 0) {
+				console.log(`Issue ${issue.number} skipped due to label found after querying for no:label.`);
+				return false;
+			}
+		} else {
+			// Make sure all labels we wanted are present.
+			if ((!issue.labels || issue.labels.length == 0) && this.labelsSet.length > 0) {
+				console.log(`Issue ${issue.number} skipped due to not having a required label set.  No labels found.`);
+				return false;
+			}
+			for (const str of this.labelsSet) {
+				if (!issue.labels.includes(str)) {
+					console.log(`Issue ${issue.number} skipped due to not having a required label set.`);
+					return false;
+				}
+			}
+			// Make sure no labels we wanted to ignore are present.
+			if (issue.labels && issue.labels.length > 0) {
+				for (const str of this.ignoreLabelsSet) {
+					if (issue.labels.includes(str)) {
+						console.log(`Issue ${issue.number} skipped due to having an ignore label set: ${str}`);
+						return false;
+					}
+				}
+			}
+		}
+		if (this.ignoreAllWithMilestones) {
+			// Validate that the issue does not have a milestone.
+			if (issue.milestoneId != null) {
+				console.log(`Issue ${issue.number} skipped due to milestone found after querying for no:milestone.`);
+				return false;
+			}
+		} else {
+			// Make sure milestone is present, if required.
+			if (this.milestoneId != undefined && issue.milestoneId != +this.milestoneId) {
+				console.log(`Issue ${issue.number} skipped due to not having required milsetone id ${this.milestoneId}.  Had: ${issue.milestoneId}`);
+				return false;
+			}
+			// Make sure a milestones we wanted to ignore is not present.
+			if (issue.milestoneId != null) {
+				for (const str of this.ignoreMilestoneIdsSet) {
+					if (issue.milestoneId == +str) {
+						console.log(`Issue ${issue.number} skipped due to milestone ${issue.milestoneId} found in list of ignored milestone IDs.`);
+						return false;
+					}
+				}
+			}
+		}
+		// Verify the issue has a sufficient number of upvotes
+		let upvotes = 0;
+		if (issue.reactions) {
+			upvotes = issue.reactions['+1'];
+		}
+		if (this.minimumVotes != undefined) {
+			if (upvotes < this.minimumVotes) {
+				console.log(`Issue ${issue.number} skipped due to not having at least ${this.minimumVotes} upvotes.  Had: ${upvotes}`);
+				return false;
+			}
+		}
+		// Verify the issue does not have too many upvotes
+		if (this.maximumVotes != undefined) {
+			if (upvotes > this.maximumVotes) {
+				console.log(`Issue ${issue.number} skipped due to having more than ${this.maximumVotes} upvotes.  Had: ${upvotes}`);
+				return false;
+			}
+		}
+		return true;
+	}
+}

.github/actions/common/utils.js

@@ -0,0 +1,99 @@
+"use strict";
+/*---------------------------------------------------------------------------------------------
+ *  Copyright (c) Microsoft Corporation. All rights reserved.
+ *  Licensed under the MIT License. See LICENSE in the project root for license information.
+ *--------------------------------------------------------------------------------------------*/
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.logErrorToIssue = exports.errorLoggingIssue = exports.getRateLimit = exports.daysAgoToHumanReadbleDate = exports.daysAgoToTimestamp = exports.loadLatestRelease = exports.normalizeIssue = exports.getRequiredInput = exports.getInput = void 0;
+const core = require("@actions/core");
+const github_1 = require("@actions/github");
+const axios_1 = require("axios");
+const octokit_1 = require("../api/octokit");
+exports.getInput = (name) => core.getInput(name) || undefined;
+exports.getRequiredInput = (name) => core.getInput(name, { required: true });
+exports.normalizeIssue = (issue) => {
+    let { body, title } = issue;
+    body = body !== null && body !== void 0 ? body : '';
+    title = title !== null && title !== void 0 ? title : '';
+    const isBug = body.includes('bug_report_template') || /Issue Type:.*Bug.*/.test(body);
+    const isFeatureRequest = body.includes('feature_request_template') || /Issue Type:.*Feature Request.*/.test(body);
+    const cleanse = (str) => {
+        let out = str
+            .toLowerCase()
+            .replace(/<!--.*-->/gu, '')
+            .replace(/.* version: .*/gu, '')
+            .replace(/issue type: .*/gu, '')
+            .replace(/vs ?code/gu, '')
+            .replace(/we have written.*please paste./gu, '')
+            .replace(/steps to reproduce:/gu, '')
+            .replace(/does this issue occur when all extensions are disabled.*/gu, '')
+            .replace(/!?\[[^\]]*\]\([^)]*\)/gu, '')
+            .replace(/\s+/gu, ' ')
+            .replace(/```[^`]*?```/gu, '');
+        while (out.includes(`<details>`) &&
+            out.includes('</details>') &&
+            out.indexOf(`</details>`) > out.indexOf(`<details>`)) {
+            out = out.slice(0, out.indexOf('<details>')) + out.slice(out.indexOf(`</details>`) + 10);
+        }
+        return out;
+    };
+    return {
+        body: cleanse(body),
+        title: cleanse(title),
+        issueType: isBug ? 'bug' : isFeatureRequest ? 'feature_request' : 'unknown',
+    };
+};
+exports.loadLatestRelease = async (quality) => (await axios_1.default.get(`https://vscode-update.azurewebsites.net/api/update/darwin/${quality}/latest`)).data;
+exports.daysAgoToTimestamp = (days) => +new Date(Date.now() - days * 24 * 60 * 60 * 1000);
+exports.daysAgoToHumanReadbleDate = (days) => new Date(Date.now() - days * 24 * 60 * 60 * 1000).toISOString().replace(/\.\d{3}\w$/, '');
+exports.getRateLimit = async (token) => {
+    const usageData = (await new github_1.GitHub(token).rateLimit.get()).data.resources;
+    const usage = {};
+    ['core', 'graphql', 'search'].forEach(async (category) => {
+        usage[category] = 1 - usageData[category].remaining / usageData[category].limit;
+    });
+    return usage;
+};
+exports.errorLoggingIssue = (() => {
+    try {
+        const repo = github_1.context.repo.owner.toLowerCase() + '/' + github_1.context.repo.repo.toLowerCase();
+        if (repo === 'microsoft/vscode-cpptools') {
+            return { repo: 'vscode-cpptools', owner: 'Microsoft', issue: 6282 };
+        }
+        else if (exports.getInput('errorLogIssueNumber')) {
+            return { ...github_1.context.repo, issue: +exports.getRequiredInput('errorLogIssueNumber') };
+        }
+        else {
+            return undefined;
+        }
+    }
+    catch (e) {
+        console.error(e);
+        return undefined;
+    }
+})();
+exports.logErrorToIssue = async (message, ping, token) => {
+    // Attempt to wait out abuse detection timeout if present
+    await new Promise((resolve) => setTimeout(resolve, 10000));
+    const dest = exports.errorLoggingIssue;
+    if (!dest)
+        return console.log('no error logging repo defined. swallowing error:', message);
+    return new octokit_1.OctoKitIssue(token, { owner: dest.owner, repo: dest.repo }, { number: dest.issue }, { readonly: !!exports.getInput('readonly') })
+        .postComment(`
+Workflow: ${github_1.context.workflow}
+
+Error: ${message}
+
+Issue: ${ping ? `${github_1.context.repo.owner}/${github_1.context.repo.repo}#` : ''}${github_1.context.issue.number}
+
+Repo: ${github_1.context.repo.owner}/${github_1.context.repo.repo}
+
+<!-- Context:
+${JSON.stringify(github_1.context, null, 2)
+        .replace(/<!--/gu, '<@--')
+        .replace(/-->/gu, '--@>')
+        .replace(/\/|\\/gu, 'slash-')}
+-->
+`);
+};
+//# sourceMappingURL=utils.js.map

.github/actions/common/utils.ts

@@ -0,0 +1,119 @@
+/*---------------------------------------------------------------------------------------------
+ *  Copyright (c) Microsoft Corporation. All rights reserved.
+ *  Licensed under the MIT License. See LICENSE in the project root for license information.
+ *--------------------------------------------------------------------------------------------*/
+
+import * as core from '@actions/core'
+import { context, GitHub } from '@actions/github'
+import axios from 'axios'
+import { OctoKitIssue } from '../api/octokit'
+
+export const getInput = (name: string) => core.getInput(name) || undefined
+export const getRequiredInput = (name: string) => core.getInput(name, { required: true })
+
+export const normalizeIssue = (issue: {
+	body: string
+	title: string
+}): { body: string; title: string; issueType: 'bug' | 'feature_request' | 'unknown' } => {
+	let { body, title } = issue
+	body = body ?? ''
+	title = title ?? ''
+	const isBug = body.includes('bug_report_template') || /Issue Type:.*Bug.*/.test(body)
+	const isFeatureRequest =
+		body.includes('feature_request_template') || /Issue Type:.*Feature Request.*/.test(body)
+
+	const cleanse = (str: string) => {
+		let out = str
+			.toLowerCase()
+			.replace(/<!--.*-->/gu, '')
+			.replace(/.* version: .*/gu, '')
+			.replace(/issue type: .*/gu, '')
+			.replace(/vs ?code/gu, '')
+			.replace(/we have written.*please paste./gu, '')
+			.replace(/steps to reproduce:/gu, '')
+			.replace(/does this issue occur when all extensions are disabled.*/gu, '')
+			.replace(/!?\[[^\]]*\]\([^)]*\)/gu, '')
+			.replace(/\s+/gu, ' ')
+			.replace(/```[^`]*?```/gu, '')
+
+		while (
+			out.includes(`<details>`) &&
+			out.includes('</details>') &&
+			out.indexOf(`</details>`) > out.indexOf(`<details>`)
+		) {
+			out = out.slice(0, out.indexOf('<details>')) + out.slice(out.indexOf(`</details>`) + 10)
+		}
+
+		return out
+	}
+
+	return {
+		body: cleanse(body),
+		title: cleanse(title),
+		issueType: isBug ? 'bug' : isFeatureRequest ? 'feature_request' : 'unknown',
+	}
+}
+
+export interface Release {
+	productVersion: string
+	timestamp: number
+	version: string
+}
+
+export const loadLatestRelease = async (quality: 'stable' | 'insider'): Promise<Release | undefined> =>
+	(await axios.get(`https://vscode-update.azurewebsites.net/api/update/darwin/${quality}/latest`)).data
+
+export const daysAgoToTimestamp = (days: number): number => +new Date(Date.now() - days * 24 * 60 * 60 * 1000)
+
+export const daysAgoToHumanReadbleDate = (days: number) =>
+	new Date(Date.now() - days * 24 * 60 * 60 * 1000).toISOString().replace(/\.\d{3}\w$/, '')
+
+export const getRateLimit = async (token: string) => {
+	const usageData = (await new GitHub(token).rateLimit.get()).data.resources
+	const usage = {} as { core: number; graphql: number; search: number }
+	;(['core', 'graphql', 'search'] as const).forEach(async (category) => {
+		usage[category] = 1 - usageData[category].remaining / usageData[category].limit
+	})
+	return usage
+}
+
+export const errorLoggingIssue = (() => {
+	try {
+		const repo = context.repo.owner.toLowerCase() + '/' + context.repo.repo.toLowerCase()
+		if (repo === 'microsoft/vscode-cpptools') {
+			return { repo: 'vscode-cpptools', owner: 'Microsoft', issue: 6282 }
+		} else if (getInput('errorLogIssueNumber')) {
+			return { ...context.repo, issue: +getRequiredInput('errorLogIssueNumber') }
+		} else {
+			return undefined
+		}
+	} catch (e) {
+		console.error(e)
+		return undefined
+	}
+})()
+
+export const logErrorToIssue = async (message: string, ping: boolean, token: string): Promise<void> => {
+	// Attempt to wait out abuse detection timeout if present
+	await new Promise((resolve) => setTimeout(resolve, 10000))
+	const dest = errorLoggingIssue
+	if (!dest) return console.log('no error logging repo defined. swallowing error:', message)
+
+	return new OctoKitIssue(token, { owner: dest.owner, repo: dest.repo }, { number: dest.issue }, { readonly: !!getInput('readonly') })
+		.postComment(`
+Workflow: ${context.workflow}
+
+Error: ${message}
+
+Issue: ${ping ? `${context.repo.owner}/${context.repo.repo}#` : ''}${context.issue.number}
+
+Repo: ${context.repo.owner}/${context.repo.repo}
+
+<!-- Context:
+${JSON.stringify(context, null, 2)
+	.replace(/<!--/gu, '<@--')
+	.replace(/-->/gu, '--@>')
+	.replace(/\/|\\/gu, 'slash-')}
+-->
+`)
+}

.github/actions/package.json

@@ -0,0 +1,24 @@
+{
+  "name": "vscode-cpptools-github-triage-actions",
+  "version": "1.0.0",
+  "description": "GitHub Actions used by VS Code cpptools for triaging issues",
+  "scripts": {
+    "build": "tsc",
+    "lint": "eslint -c .eslintrc --fix --ext .ts .",
+    "watch": "tsc --watch"
+  },
+  "keywords": [],
+  "author": "",
+  "dependencies": {
+    "@actions/core": "^1.9.1",
+    "@actions/github": "^2.1.1",
+    "axios": "^0.21.4"
+  },
+  "resolutions": {
+    "follow-redirects": "1.14.7"
+  },
+  "devDependencies": {
+    "eslint": "^8.1.0",
+    "typescript": "^3.8.3"
+  }
+}

.github/actions/tsconfig.json

@@ -0,0 +1,18 @@
+{
+	"compilerOptions": {
+		"target": "es2019",
+		"strict": true,
+		"module": "commonjs",
+		"moduleResolution": "node",
+		"removeComments": false,
+		"resolveJsonModule": true,
+		"sourceMap": true,
+		"lib": [
+			"es2020"
+		]
+	},
+	"exclude": [
+		"**/*.test.ts",
+		"**/vm-filesystem/**"
+	]
+}

.github/workflows/by-design-closer-debugger .yml

@@ -0,0 +1,26 @@
+name: By Design closer - debugger
+on:
+  schedule:
+    - cron: 10 11 * * * # Run at 11:10 AM UTC (3:10 AM PST, 4:10 AM PDT)
+  workflow_dispatch:
+   inputs:
+     readonly:
+       description: "readonly: Specify true or 1 to prevent changes from being commited to GitHub"
+       default: false
+
+jobs:
+  main:
+    runs-on: ubuntu-latest
+    steps:
+      - name: Checkout Actions
+        uses: actions/checkout@v2
+      - name: Install Actions
+        run: cd ./.github/actions && npm install --production && cd ../..
+      - name: Stale Closer
+        uses: ./.github/actions/StaleCloser
+        with:
+          readonly: ${{ github.event.inputs.readonly }}
+          labels: by design,debugger
+          ignoreLabels: language service,internal
+          closeDays: 0
+          closeComment: "This issue has been closed because the described behavior was determined to be by design."

.github/workflows/by-design-closer.yml

@@ -0,0 +1,28 @@
+name: By Design Closer
+on:
+  schedule:
+    - cron: 0 12 * * * # Run at 12:00 PM UTC (4:00 AM PST, 5:00 AM PDT)
+  workflow_dispatch:
+   inputs:
+     readonly:
+       description: "readonly: Specify true or 1 to prevent changes from being commited to GitHub"
+       default: false
+
+jobs:
+  main:
+    runs-on: ubuntu-latest
+    steps:
+      - name: Checkout Actions
+        uses: actions/checkout@v2
+      - name: Install Actions
+        run: cd ./.github/actions && npm install --production && cd ../..
+      - name: Stale Closer
+        uses: ./.github/actions/StaleCloser
+        with:
+          readonly: ${{ github.event.inputs.readonly }}
+          labels: by design
+          ignoreLabels: debugger,Feature Request,more info needed,internal
+          closeDays: 60
+          closeComment: "This issue has been closed because the described behavior was determined to be by design."
+          pingDays: 80
+          pingComment: "Hey @${assignee}, this issue might need further attention.\n\n@${author}, you can help us out by closing this issue if it is no longer relevant."

.github/workflows/ci_linux.yml

@@ -0,0 +1,47 @@
+name: CI (Linux)
+
+on:
+  push:
+    branches: [ main ]
+  pull_request:
+    branches: [ main ]
+
+jobs:
+  build:
+    runs-on: ubuntu-latest
+
+    steps:
+      - uses: actions/checkout@v2
+
+      - name: Use Node.js 14.16.x
+        uses: actions/setup-node@v1
+        with:
+          node-version: 14.16.x
+
+      - name: Install Dependencies
+        run: yarn install
+        working-directory: Extension
+
+      - name: Compile Sources
+        run: yarn run compile
+        working-directory: Extension
+
+      - name: Run Linter
+        run: yarn run lint
+        working-directory: Extension
+
+      - name: Compile Test Sources
+        run: yarn run pretest
+        working-directory: Extension
+
+      - name: Run unit tests
+        uses: GabrielBB/[email protected]
+        with:
+          run: yarn run unitTests
+          working-directory: Extension
+
+#      - name: Run languageServer integration tests
+#        uses: GabrielBB/[email protected]
+#        with:
+#          run: yarn run integrationTests
+#          working-directory: Extension

.github/workflows/ci_mac.yml

@@ -0,0 +1,47 @@
+name: CI (Mac)
+
+on:
+  push:
+    branches: [ main ]
+  pull_request:
+    branches: [ main ]
+
+jobs:
+  build:
+    runs-on: macos-latest
+
+    steps:
+      - uses: actions/checkout@v2
+
+      - name: Use Node.js 14.16.x
+        uses: actions/setup-node@v1
+        with:
+          node-version: 14.16.x
+
+      - name: Install Dependencies
+        run: yarn install --network-timeout 100000
+        working-directory: Extension
+
+      - name: Compile Sources
+        run: yarn run compile
+        working-directory: Extension
+
+      - name: Run Linter
+        run: yarn run lint
+        working-directory: Extension
+
+      - name: Compile Test Sources
+        run: yarn run pretest
+        working-directory: Extension
+
+      - name: Run unit tests
+        uses: GabrielBB/[email protected]
+        with:
+          run: yarn run unitTests
+          working-directory: Extension
+
+#      - name: Run languageServer integration tests
+#        uses: GabrielBB/[email protected]
+#        with:
+#          run: yarn run integrationTests
+#          working-directory: Extension

.github/workflows/ci_windows.yml

@@ -0,0 +1,43 @@
+name: CI (Windows)
+
+on:
+  push:
+    branches: [ main ]
+  pull_request:
+    branches: [ main ]
+
+jobs:
+  build:
+    runs-on: windows-latest
+
+    steps:
+      - uses: actions/checkout@v2
+
+      - name: Use Node.js 14.16.x
+        uses: actions/setup-node@v1
+        with:
+          node-version: 14.16.x
+
+      - name: Install Dependencies
+        run: yarn install
+        working-directory: Extension
+
+      - name: Compile Sources
+        run: yarn run compile
+        working-directory: Extension
+
+      - name: Run Linter
+        run: yarn run lint
+        working-directory: Extension
+
+      - name: Compile Test Sources
+        run: yarn run pretest
+        working-directory: Extension
+
+      - name: Run unit tests
+        run: yarn run unitTests
+        working-directory: Extension
+
+#      - name: Run languageServer integration tests
+#        run: yarn run integrationTests
+#        working-directory: Extension

.github/workflows/duplicate-closer.yml

@@ -0,0 +1,28 @@
+name: Duplicate Closer
+on:
+  schedule:
+    - cron: 10 12 * * * # Run at 12:10 PM UTC (4:10 AM PST, 5:10 AM PDT)
+  workflow_dispatch:
+   inputs:
+     readonly:
+       description: "readonly: Specify true or 1 to prevent changes from being commited to GitHub"
+       default: false
+
+jobs:
+  main:
+    runs-on: ubuntu-latest
+    steps:
+      - name: Checkout Actions
+        uses: actions/checkout@v2
+      - name: Install Actions
+        run: cd ./.github/actions && npm install --production && cd ../..
+      - name: Stale Closer
+        uses: ./.github/actions/StaleCloser
+        with:
+          readonly: ${{ github.event.inputs.readonly }}
+          labels: duplicate
+          ignoreLabels: debugger,Feature Request,more info needed,by design,internal
+          closeDays: 60
+          closeComment: "This issue has been closed because it is a duplicate of another issue we are tracking."
+          pingDays: 80
+          pingComment: "Hey @${assignee}, this issue might need further attention.\n\n@${author}, you can help us out by closing this issue if it is no longer relevant."

.github/workflows/enhancement-closer-no-milestone.yml

@@ -0,0 +1,30 @@
+name: Enhancement Closer (no milestone)
+on:
+  schedule:
+    - cron: 50 11 * * * # Run at 11:50 AM UTC (3:50 AM PST, 4:50 AM PDT)
+  workflow_dispatch:
+   inputs:
+     readonly:
+       description: "readonly: Specify true or 1 to prevent changes from being commited to GitHub"
+       default: false
+
+jobs:
+  main:
+    runs-on: ubuntu-latest
+    steps:
+      - name: Checkout Actions
+        uses: actions/checkout@v2
+      - name: Install Actions
+        run: cd ./.github/actions && npm install --production && cd ../..
+      - name: Stale Closer
+        uses: ./.github/actions/StaleCloser
+        with:
+          readonly: ${{ github.event.inputs.readonly }}
+          labels: enhancement
+          ignoreLabels: debugger,internal,Feature Request
+          addLabels: more votes needed
+          closeDays: 60
+          maximumVotes: 2
+          closeComment: "This feature request is being closed due to insufficient upvotes. Please leave a 👍-upvote or 👎-downvote reaction on the issue to help us prioritize it. When enough upvotes are received, this issue will be eligible for our backlog."
+          setMilestoneId: 30
+          ignoreMilestoneNames: "*"

.github/workflows/enhancement-closer-triage.yml

@@ -0,0 +1,30 @@
+name: Enhancement Closer (Triage)
+on:
+  schedule:
+    - cron: 40 11 * * * # Run at 11:40 AM UTC (3:40 AM PST, 4:40 AM PDT)
+  workflow_dispatch:
+   inputs:
+     readonly:
+       description: "readonly: Specify true or 1 to prevent changes from being commited to GitHub"
+       default: false
+
+jobs:
+  main:
+    runs-on: ubuntu-latest
+    steps:
+      - name: Checkout Actions
+        uses: actions/checkout@v2
+      - name: Install Actions
+        run: cd ./.github/actions && npm install --production && cd ../..
+      - name: Stale Closer
+        uses: ./.github/actions/StaleCloser
+        with:
+          readonly: ${{ github.event.inputs.readonly }}
+          labels: enhancement
+          ignoreLabels: debugger,internal,Feature Request
+          addLabels: more votes needed
+          closeDays: 60
+          maximumVotes: 2
+          closeComment: "This feature request is being closed due to insufficient upvotes. Please leave a 👍-upvote or 👎-downvote reaction on the issue to help us prioritize it. When enough upvotes are received, this issue will be eligible for our backlog."
+          milestoneName: Triage
+          milestoneId: 30

.github/workflows/enhancement-reopener.yml

@@ -0,0 +1,31 @@
+name: Enhancement Reopener
+on:
+  schedule:
+    - cron: 20 12 * * * # Run at 12:20 PM UTC (4:20 AM PST, 5:20 AM PDT)
+  workflow_dispatch:
+   inputs:
+     readonly:
+       description: "readonly: Specify true or 1 to prevent changes from being commited to GitHub"
+       default: false
+
+jobs:
+  main:
+    runs-on: ubuntu-latest
+    steps:
+      - name: Checkout Actions
+        uses: actions/checkout@v2
+      - name: Install Actions
+        run: cd ./.github/actions && npm install --production && cd ../..
+      - name: Run Reopener
+        uses: ./.github/actions/Reopener
+        with:
+          readonly: ${{ github.event.inputs.readonly }}
+          alsoApplyToOpenIssues: true
+          reopenComment: This feature request has received enough votes to be added to our backlog.
+          labels: enhancement
+          minimumVotes: 3
+          ignoreLabels: debugger,internal,Feature Request
+          milestoneId: 30
+          milestoneName: Triage
+          setMilestoneId: 28
+          removeLabels: more votes needed

.github/workflows/external-closer-debugger.yml

@@ -0,0 +1,26 @@
+name: External closer - debugger
+on:
+  schedule:
+    - cron: 10 11 * * * # Run at 11:10 AM UTC (3:10 AM PST, 4:10 AM PDT)
+  workflow_dispatch:
+   inputs:
+     readonly:
+       description: "readonly: Specify true or 1 to prevent changes from being commited to GitHub"
+       default: false
+
+jobs:
+  main:
+    runs-on: ubuntu-latest
+    steps:
+      - name: Checkout Actions
+        uses: actions/checkout@v2
+      - name: Install Actions
+        run: cd ./.github/actions && npm install --production && cd ../..
+      - name: Stale Closer
+        uses: ./.github/actions/StaleCloser
+        with:
+          readonly: ${{ github.event.inputs.readonly }}
+          labels: external,debugger
+          ignoreLabels: language service,internal
+          closeDays: 0
+          closeComment: "This issue has been closed because it is external or not applicable to the extension."

.github/workflows/feature-request-closer-no-milestone.yml

@@ -0,0 +1,30 @@
+name: Feature Request Closer (no milestone)
+on:
+  schedule:
+    - cron: 50 11 * * * # Run at 11:50 AM UTC (3:50 AM PST, 4:50 AM PDT)
+  workflow_dispatch:
+   inputs:
+     readonly:
+       description: "readonly: Specify true or 1 to prevent changes from being commited to GitHub"
+       default: false
+
+jobs:
+  main:
+    runs-on: ubuntu-latest
+    steps:
+      - name: Checkout Actions
+        uses: actions/checkout@v2
+      - name: Install Actions
+        run: cd ./.github/actions && npm install --production && cd ../..
+      - name: Stale Closer
+        uses: ./.github/actions/StaleCloser
+        with:
+          readonly: ${{ github.event.inputs.readonly }}
+          labels: Feature Request
+          ignoreLabels: debugger,internal
+          addLabels: more votes needed
+          closeDays: 60
+          maximumVotes: 2
+          closeComment: "This feature request is being closed due to insufficient upvotes. Please leave a 👍-upvote or 👎-downvote reaction on the issue to help us prioritize it. When enough upvotes are received, this issue will be eligible for our backlog."
+          setMilestoneId: 30
+          ignoreMilestoneNames: "*"

.github/workflows/feature-request-closer-triage.yml

@@ -0,0 +1,30 @@
+name: Feature Request Closer (Triage)
+on:
+  schedule:
+    - cron: 40 11 * * * # Run at 11:40 AM UTC (3:40 AM PST, 4:40 AM PDT)
+  workflow_dispatch:
+   inputs:
+     readonly:
+       description: "readonly: Specify true or 1 to prevent changes from being commited to GitHub"
+       default: false
+
+jobs:
+  main:
+    runs-on: ubuntu-latest
+    steps:
+      - name: Checkout Actions
+        uses: actions/checkout@v2
+      - name: Install Actions
+        run: cd ./.github/actions && npm install --production && cd ../..
+      - name: Stale Closer
+        uses: ./.github/actions/StaleCloser
+        with:
+          readonly: ${{ github.event.inputs.readonly }}
+          labels: Feature Request
+          ignoreLabels: debugger,internal
+          addLabels: more votes needed
+          closeDays: 60
+          maximumVotes: 2
+          closeComment: "This feature request is being closed due to insufficient upvotes. Please leave a 👍-upvote or 👎-downvote reaction on the issue to help us prioritize it. When enough upvotes are received, this issue will be eligible for our backlog."
+          milestoneName: Triage
+          milestoneId: 30

.github/workflows/feature-request-reopener.yml

@@ -0,0 +1,31 @@
+name: Feature Request Reopener
+on:
+  schedule:
+    - cron: 20 12 * * * # Run at 12:20 PM UTC (4:20 AM PST, 5:20 AM PDT)
+  workflow_dispatch:
+   inputs:
+     readonly:
+       description: "readonly: Specify true or 1 to prevent changes from being commited to GitHub"
+       default: false
+
+jobs:
+  main:
+    runs-on: ubuntu-latest
+    steps:
+      - name: Checkout Actions
+        uses: actions/checkout@v2
+      - name: Install Actions
+        run: cd ./.github/actions && npm install --production && cd ../..
+      - name: Run Reopener
+        uses: ./.github/actions/Reopener
+        with:
+          readonly: ${{ github.event.inputs.readonly }}
+          alsoApplyToOpenIssues: true
+          reopenComment: This feature request has received enough votes to be added to our backlog.
+          labels: Feature Request
+          minimumVotes: 3
+          ignoreLabels: debugger,internal
+          milestoneId: 30
+          milestoneName: Triage
+          setMilestoneId: 28
+          removeLabels: more votes needed

.github/workflows/investigate-closer-debugger.yml

@@ -0,0 +1,26 @@
+name: Investigate closer - debugger
+on:
+  schedule:
+    - cron: 10 11 * * * # Run at 11:10 AM UTC (3:10 AM PST, 4:10 AM PDT)
+  workflow_dispatch:
+   inputs:
+     readonly:
+       description: "readonly: Specify true or 1 to prevent changes from being commited to GitHub"
+       default: false
+
+jobs:
+  main:
+    runs-on: ubuntu-latest
+    steps:
+      - name: Checkout Actions
+        uses: actions/checkout@v2
+      - name: Install Actions
+        run: cd ./.github/actions && npm install --production && cd ../..
+      - name: Stale Closer
+        uses: ./.github/actions/StaleCloser
+        with:
+          readonly: ${{ github.event.inputs.readonly }}
+          labels: investigate,debugger
+          ignoreLabels: language service,internal
+          closeDays: 180
+          closeComment: "This issue has been closed as lower priority. We're sorry if this issue still impacts you but unfortunately we're not able to address this. We will accept a pull request from the community if it's applicable for this issue."

.github/workflows/investigate-costing-closer-debugger.yml

@@ -0,0 +1,26 @@
+name: Investigate Costing closer - debugger
+on:
+  schedule:
+    - cron: 10 11 * * * # Run at 11:10 AM UTC (3:10 AM PST, 4:10 AM PDT)
+  workflow_dispatch:
+   inputs:
+     readonly:
+       description: "readonly: Specify true or 1 to prevent changes from being commited to GitHub"
+       default: false
+
+jobs:
+  main:
+    runs-on: ubuntu-latest
+    steps:
+      - name: Checkout Actions
+        uses: actions/checkout@v2
+      - name: Install Actions
+        run: cd ./.github/actions && npm install --production && cd ../..
+      - name: Stale Closer
+        uses: ./.github/actions/StaleCloser
+        with:
+          readonly: ${{ github.event.inputs.readonly }}
+          labels: "investigate: costing,debugger"
+          ignoreLabels: language service,internal
+          closeDays: 180
+          closeComment: "This issue has been closed as lower priority. We're sorry if this issue still impacts you but unfortunately we're not able to address this. We will accept a pull request from the community if it's applicable for this issue."

.github/workflows/locker.yml

@@ -0,0 +1,25 @@
+name: Locker
+on:
+  schedule:
+    - cron: 30 11 * * * # Run at 11:30 AM UTC (3:30 AM PST, 4:30 AM PDT)
+  workflow_dispatch:
+   inputs:
+     readonly:
+       description: "readonly: Specify true or 1 to prevent changes from being commited to GitHub"
+       default: false
+
+jobs:
+  main:
+    runs-on: ubuntu-latest
+    steps:
+      - name: Checkout Actions
+        uses: actions/checkout@v2
+      - name: Install Actions
+        run: cd ./.github/actions && npm install --production && cd ../..
+      - name: Run Locker
+        uses: ./.github/actions/Locker
+        with:
+          readonly: ${{ github.event.inputs.readonly }}
+          daysSinceClose: 45
+          daysSinceUpdate: 3
+          ignoreLabels: more votes needed,debugger,internal

.github/workflows/more-info-needed-closer-debugger.yml

@@ -0,0 +1,29 @@
+name: More Info Needed Closer - debugger
+on:
+  schedule:
+    - cron: 10 11 * * * # Run at 11:10 AM UTC (3:10 AM PST, 4:10 AM PDT)
+  workflow_dispatch:
+   inputs:
+     readonly:
+       description: "readonly: Specify true or 1 to prevent changes from being commited to GitHub"
+       default: false
+
+jobs:
+  main:
+    runs-on: ubuntu-latest
+    steps:
+      - name: Checkout Actions
+        uses: actions/checkout@v2
+      - name: Install Actions
+        run: cd ./.github/actions && npm install --production && cd ../..
+      - name: Stale Closer
+        uses: ./.github/actions/StaleCloser
+        with:
+          readonly: ${{ github.event.inputs.readonly }}
+          labels: more info needed,debugger
+          ignoreLabels: language service,internal
+          involves: wardengnaw,pieandcakes,calgagi
+          closeDays: 14
+          closeComment: "This issue has been closed because it needs more information and has not had recent activity."
+          pingDays: 7
+          pingComment: "Hey @${assignee}, this issue might need further attention.\n\n@${author}, you can help us out by closing this issue if the problem no longer exists, or adding more information."

.github/workflows/more-info-needed-closer.yml

@@ -0,0 +1,28 @@
+name: More Info Needed Closer
+on:
+  schedule:
+    - cron: 10 11 * * * # Run at 11:10 AM UTC (3:10 AM PST, 4:10 AM PDT)
+  workflow_dispatch:
+   inputs:
+     readonly:
+       description: "readonly: Specify true or 1 to prevent changes from being commited to GitHub"
+       default: false
+
+jobs:
+  main:
+    runs-on: ubuntu-latest
+    steps:
+      - name: Checkout Actions
+        uses: actions/checkout@v2
+      - name: Install Actions
+        run: cd ./.github/actions && npm install --production && cd ../..
+      - name: Stale Closer
+        uses: ./.github/actions/StaleCloser
+        with:
+          readonly: ${{ github.event.inputs.readonly }}
+          labels: more info needed
+          ignoreLabels: debugger,internal
+          closeDays: 60
+          closeComment: "This issue has been closed because it needs more information and has not had recent activity."
+          pingDays: 80
+          pingComment: "Hey @${assignee}, this issue might need further attention.\n\n@${author}, you can help us out by closing this issue if the problem no longer exists, or adding more information."

.github/workflows/question-closer-debugger.yml

@@ -0,0 +1,29 @@
+name: Question Closer - debugger
+on:
+  schedule:
+    - cron: 20 11 * * * # Run at 11:20 AM UTC (3:20 AM PST, 4:20 AM PDT)
+  workflow_dispatch:
+   inputs:
+     readonly:
+       description: "readonly: Specify true or 1 to prevent changes from being commited to GitHub"
+       default: false
+
+jobs:
+  main:
+    runs-on: ubuntu-latest
+    steps:
+      - name: Checkout Actions
+        uses: actions/checkout@v2
+      - name: Install Actions
+        run: cd ./.github/actions && npm install --production && cd ../..
+      - name: Stale Closer
+        uses: ./.github/actions/StaleCloser
+        with:
+          readonly: ${{ github.event.inputs.readonly }}
+          labels: question,debugger
+          ignoreLabels: language service,internal
+          involves: wardengnaw,pieandcakes,calgagi
+          closeDays: 14
+          closeComment: "This issue has been closed because it is a question and has not had recent activity."
+          pingDays: 7
+          pingComment: "Hey @${assignee}, this issue might need further attention.\n\n@${author}, you can help us out by closing this issue if the question has been answered."

.github/workflows/question-closer.yml

@@ -0,0 +1,28 @@
+name: Question Closer
+on:
+  schedule:
+    - cron: 20 11 * * * # Run at 11:20 AM UTC (3:20 AM PST, 4:20 AM PDT)
+  workflow_dispatch:
+   inputs:
+     readonly:
+       description: "readonly: Specify true or 1 to prevent changes from being commited to GitHub"
+       default: false
+
+jobs:
+  main:
+    runs-on: ubuntu-latest
+    steps:
+      - name: Checkout Actions
+        uses: actions/checkout@v2
+      - name: Install Actions
+        run: cd ./.github/actions && npm install --production && cd ../..
+      - name: Stale Closer
+        uses: ./.github/actions/StaleCloser
+        with:
+          readonly: ${{ github.event.inputs.readonly }}
+          labels: question
+          ignoreLabels: debugger,internal
+          closeDays: 60
+          closeComment: "This issue has been closed because it is a question and has not had recent activity."
+          pingDays: 80
+          pingComment: "Hey @${assignee}, this issue might need further attention.\n\n@${author}, you can help us out by closing this issue if the question has been answered."

.gitignore

@@ -0,0 +1,15 @@
+# ignore cache files for sample projects
+.vscode/ipch
+browse*.db*
+*.obj
+*.pdb
+*.exe
+*.ilk
+
+# ignore exported localization xlf and LCL directories
+Build/loc/LCL
+vscode-extensions-localization-export
+OneLocBuild
+
+# ignore imported localization xlf directory
+vscode-translations-import

.travis.yml

@@ -1,43 +0,0 @@
-language: node_js
-
-node_js:
-- "8"
-
-before_install:
-  # Do not modify. Required for GUI based tests: See https://docs.travis-ci.com/user/gui-and-headless-browsers/#Using-xvfb-to-Run-Tests-That-Require-a-GUI
-  - if [ $TRAVIS_OS_NAME == "linux" ]; then
-      export CXX="g++-4.9" CC="gcc-4.9" DISPLAY=:99.0;
-      sh -e /etc/init.d/xvfb start;
-      sleep 3;
-    fi
-
-addons:
-  apt:
-    sources:
-      - ubuntu-toolchain-r-test
-      - sourceline: 'deb https://packages.microsoft.com/repos/microsoft-ubuntu-trusty-prod trusty main'
-        key_url: 'https://packages.microsoft.com/keys/microsoft.asc'
-    packages:
-      - gdb
-      - g++-4.9
-
-
-script:
-  # Download debugAdapters from an existing extension version. See TravisCI settings to set CPPTOOL_VERSION
-  - mkdir -p ~/.vscode/extensions/ms-vscode.cpptools-$CPPTOOL_VERSION
-  - wget https://github.com/Microsoft/vscode-cpptools/releases/download/$CPPTOOL_VERSION/cpptools.vsix -O ~/cpptools.vsix
-  - unzip ~/cpptools.vsix "extension/debugAdapters/*" -d ~/.
-  - mv ~/extension/debugAdapters ~/.vscode/extensions/ms-vscode.cpptools-$CPPTOOL_VERSION/debugAdapters
-  # Build and then run tests
-  - cd Extension
-  - npm install
-  - npm run tslint
-  - npm run compile
-  - npm run test
-
-after_failure:
-  - find ~ -name "integrationTests.log" -type f -exec cat {} \;
-
-after_success:
-  - find ~ -name "integrationTests.log" -type f -exec cat {} \;
-  

Build/lldb-mi/NOTICE.TXT

@@ -0,0 +1,299 @@
+NOTICES AND INFORMATION
+Do Not Translate or Localize
+
+This software incorporates material from third parties. Microsoft makes certain
+open source code available at https://3rdpartysource.microsoft.com, or you may
+send a check or money order for US $5.00, including the product name, the open
+source component name, and version number, to:
+
+Source Code Compliance Team
+Microsoft Corporation
+One Microsoft Way
+Redmond, WA 98052
+USA
+
+Notwithstanding any other terms, you may reverse engineer this software to the
+extent required to debug changes to any libraries licensed under the GNU Lesser
+General Public License.
+
+---
+
+LLDB-MI
+
+==============================================================================
+The LLVM Project is under the Apache License v2.0 with LLVM Exceptions:
+==============================================================================
+
+                                 Apache License
+                           Version 2.0, January 2004
+                        http://www.apache.org/licenses/
+
+    TERMS AND CONDITIONS FOR USE, REPRODUCTION, AND DISTRIBUTION
+
+    1. Definitions.
+
+      "License" shall mean the terms and conditions for use, reproduction,
+      and distribution as defined by Sections 1 through 9 of this document.
+
+      "Licensor" shall mean the copyright owner or entity authorized by
+      the copyright owner that is granting the License.
+
+      "Legal Entity" shall mean the union of the acting entity and all
+      other entities that control, are controlled by, or are under common
+      control with that entity. For the purposes of this definition,
+      "control" means (i) the power, direct or indirect, to cause the
+      direction or management of such entity, whether by contract or
+      otherwise, or (ii) ownership of fifty percent (50%) or more of the
+      outstanding shares, or (iii) beneficial ownership of such entity.
+
+      "You" (or "Your") shall mean an individual or Legal Entity
+      exercising permissions granted by this License.
+
+      "Source" form shall mean the preferred form for making modifications,
+      including but not limited to software source code, documentation
+      source, and configuration files.
+
+      "Object" form shall mean any form resulting from mechanical
+      transformation or translation of a Source form, including but
+      not limited to compiled object code, generated documentation,
+      and conversions to other media types.
+
+      "Work" shall mean the work of authorship, whether in Source or
+      Object form, made available under the License, as indicated by a
+      copyright notice that is included in or attached to the work
+      (an example is provided in the Appendix below).
+
+      "Derivative Works" shall mean any work, whether in Source or Object
+      form, that is based on (or derived from) the Work and for which the
+      editorial revisions, annotations, elaborations, or other modifications
+      represent, as a whole, an original work of authorship. For the purposes
+      of this License, Derivative Works shall not include works that remain
+      separable from, or merely link (or bind by name) to the interfaces of,
+      the Work and Derivative Works thereof.
+
+      "Contribution" shall mean any work of authorship, including
+      the original version of the Work and any modifications or additions
+      to that Work or Derivative Works thereof, that is intentionally
+      submitted to Licensor for inclusion in the Work by the copyright owner
+      or by an individual or Legal Entity authorized to submit on behalf of
+      the copyright owner. For the purposes of this definition, "submitted"
+      means any form of electronic, verbal, or written communication sent
+      to the Licensor or its representatives, including but not limited to
+      communication on electronic mailing lists, source code control systems,
+      and issue tracking systems that are managed by, or on behalf of, the
+      Licensor for the purpose of discussing and improving the Work, but
+      excluding communication that is conspicuously marked or otherwise
+      designated in writing by the copyright owner as "Not a Contribution."
+
+      "Contributor" shall mean Licensor and any individual or Legal Entity
+      on behalf of whom a Contribution has been received by Licensor and
+      subsequently incorporated within the Work.
+
+    2. Grant of Copyright License. Subject to the terms and conditions of
+      this License, each Contributor hereby grants to You a perpetual,
+      worldwide, non-exclusive, no-charge, royalty-free, irrevocable
+      copyright license to reproduce, prepare Derivative Works of,
+      publicly display, publicly perform, sublicense, and distribute the
+      Work and such Derivative Works in Source or Object form.
+
+    3. Grant of Patent License. Subject to the terms and conditions of
+      this License, each Contributor hereby grants to You a perpetual,
+      worldwide, non-exclusive, no-charge, royalty-free, irrevocable
+      (except as stated in this section) patent license to make, have made,
+      use, offer to sell, sell, import, and otherwise transfer the Work,
+      where such license applies only to those patent claims licensable
+      by such Contributor that are necessarily infringed by their
+      Contribution(s) alone or by combination of their Contribution(s)
+      with the Work to which such Contribution(s) was submitted. If You
+      institute patent litigation against any entity (including a
+      cross-claim or counterclaim in a lawsuit) alleging that the Work
+      or a Contribution incorporated within the Work constitutes direct
+      or contributory patent infringement, then any patent licenses
+      granted to You under this License for that Work shall terminate
+      as of the date such litigation is filed.
+
+    4. Redistribution. You may reproduce and distribute copies of the
+      Work or Derivative Works thereof in any medium, with or without
+      modifications, and in Source or Object form, provided that You
+      meet the following conditions:
+
+      (a) You must give any other recipients of the Work or
+          Derivative Works a copy of this License; and
+
+      (b) You must cause any modified files to carry prominent notices
+          stating that You changed the files; and
+
+      (c) You must retain, in the Source form of any Derivative Works
+          that You distribute, all copyright, patent, trademark, and
+          attribution notices from the Source form of the Work,
+          excluding those notices that do not pertain to any part of
+          the Derivative Works; and
+
+      (d) If the Work includes a "NOTICE" text file as part of its
+          distribution, then any Derivative Works that You distribute must
+          include a readable copy of the attribution notices contained
+          within such NOTICE file, excluding those notices that do not
+          pertain to any part of the Derivative Works, in at least one
+          of the following places: within a NOTICE text file distributed
+          as part of the Derivative Works; within the Source form or
+          documentation, if provided along with the Derivative Works; or,
+          within a display generated by the Derivative Works, if and
+          wherever such third-party notices normally appear. The contents
+          of the NOTICE file are for informational purposes only and
+          do not modify the License. You may add Your own attribution
+          notices within Derivative Works that You distribute, alongside
+          or as an addendum to the NOTICE text from the Work, provided
+          that such additional attribution notices cannot be construed
+          as modifying the License.
+
+      You may add Your own copyright statement to Your modifications and
+      may provide additional or different license terms and conditions
+      for use, reproduction, or distribution of Your modifications, or
+      for any such Derivative Works as a whole, provided Your use,
+      reproduction, and distribution of the Work otherwise complies with
+      the conditions stated in this License.
+
+    5. Submission of Contributions. Unless You explicitly state otherwise,
+      any Contribution intentionally submitted for inclusion in the Work
+      by You to the Licensor shall be under the terms and conditions of
+      this License, without any additional terms or conditions.
+      Notwithstanding the above, nothing herein shall supersede or modify
+      the terms of any separate license agreement you may have executed
+      with Licensor regarding such Contributions.
+
+    6. Trademarks. This License does not grant permission to use the trade
+      names, trademarks, service marks, or product names of the Licensor,
+      except as required for reasonable and customary use in describing the
+      origin of the Work and reproducing the content of the NOTICE file.
+
+    7. Disclaimer of Warranty. Unless required by applicable law or
+      agreed to in writing, Licensor provides the Work (and each
+      Contributor provides its Contributions) on an "AS IS" BASIS,
+      WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or
+      implied, including, without limitation, any warranties or conditions
+      of TITLE, NON-INFRINGEMENT, MERCHANTABILITY, or FITNESS FOR A
+      PARTICULAR PURPOSE. You are solely responsible for determining the
+      appropriateness of using or redistributing the Work and assume any
+      risks associated with Your exercise of permissions under this License.
+
+    8. Limitation of Liability. In no event and under no legal theory,
+      whether in tort (including negligence), contract, or otherwise,
+      unless required by applicable law (such as deliberate and grossly
+      negligent acts) or agreed to in writing, shall any Contributor be
+      liable to You for damages, including any direct, indirect, special,
+      incidental, or consequential damages of any character arising as a
+      result of this License or out of the use or inability to use the
+      Work (including but not limited to damages for loss of goodwill,
+      work stoppage, computer failure or malfunction, or any and all
+      other commercial damages or losses), even if such Contributor
+      has been advised of the possibility of such damages.
+
+    9. Accepting Warranty or Additional Liability. While redistributing
+      the Work or Derivative Works thereof, You may choose to offer,
+      and charge a fee for, acceptance of support, warranty, indemnity,
+      or other liability obligations and/or rights consistent with this
+      License. However, in accepting such obligations, You may act only
+      on Your own behalf and on Your sole responsibility, not on behalf
+      of any other Contributor, and only if You agree to indemnify,
+      defend, and hold each Contributor harmless for any liability
+      incurred by, or claims asserted against, such Contributor by reason
+      of your accepting any such warranty or additional liability.
+
+    END OF TERMS AND CONDITIONS
+
+    APPENDIX: How to apply the Apache License to your work.
+
+      To apply the Apache License to your work, attach the following
+      boilerplate notice, with the fields enclosed by brackets "[]"
+      replaced with your own identifying information. (Don't include
+      the brackets!)  The text should be enclosed in the appropriate
+      comment syntax for the file format. We also recommend that a
+      file or class name and description of purpose be included on the
+      same "printed page" as the copyright notice for easier
+      identification within third-party archives.
+
+    Copyright [yyyy] [name of copyright owner]
+
+    Licensed under the Apache License, Version 2.0 (the "License");
+    you may not use this file except in compliance with the License.
+    You may obtain a copy of the License at
+
+       http://www.apache.org/licenses/LICENSE-2.0
+
+    Unless required by applicable law or agreed to in writing, software
+    distributed under the License is distributed on an "AS IS" BASIS,
+    WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+    See the License for the specific language governing permissions and
+    limitations under the License.
+
+
+---- LLVM Exceptions to the Apache 2.0 License ----
+
+As an exception, if, as a result of your compiling your source code, portions
+of this Software are embedded into an Object form of such source code, you
+may redistribute such embedded portions in such Object form without complying
+with the conditions of Sections 4(a), 4(b) and 4(d) of the License.
+
+In addition, if you combine or link compiled forms of this Software with
+software that is licensed under the GPLv2 ("Combined Software") and if a
+court of competent jurisdiction determines that the patent provision (Section
+3), the indemnity provision (Section 9) or other Section of the License
+conflicts with the conditions of the GPLv2, you may retroactively and
+prospectively choose to deem waived or otherwise exclude such Section(s) of
+the License, but only in their entirety and only with respect to the Combined
+Software.
+
+==============================================================================
+Software from third parties included in the LLVM Project:
+==============================================================================
+The LLVM Project contains third party software which is under different license
+terms. All such code will be identified clearly using at least one of two
+mechanisms:
+1) It will be in a separate directory tree with its own `LICENSE.txt` or
+   `LICENSE` file at the top containing the specific license and restrictions
+   which apply to that software, or
+2) It will contain specific license and restriction terms at the top of every
+   file.
+
+==============================================================================
+Legacy LLVM License (https://llvm.org/docs/DeveloperPolicy.html#legacy):
+==============================================================================
+University of Illinois/NCSA
+Open Source License
+
+Copyright (c) 2010 Apple Inc.
+All rights reserved.
+
+Developed by:
+
+    LLDB Team
+
+    http://lldb.llvm.org/
+
+Permission is hereby granted, free of charge, to any person obtaining a copy of
+this software and associated documentation files (the "Software"), to deal with
+the Software without restriction, including without limitation the rights to
+use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies
+of the Software, and to permit persons to whom the Software is furnished to do
+so, subject to the following conditions:
+
+    * Redistributions of source code must retain the above copyright notice,
+      this list of conditions and the following disclaimers.
+
+    * Redistributions in binary form must reproduce the above copyright notice,
+      this list of conditions and the following disclaimers in the
+      documentation and/or other materials provided with the distribution.
+
+    * Neither the names of the LLDB Team, copyright holders, nor the names of 
+      its contributors may be used to endorse or promote products derived from 
+      this Software without specific prior written permission.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS
+FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT.  IN NO EVENT SHALL THE
+CONTRIBUTORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS WITH THE
+SOFTWARE.
+
+---

Build/lldb-mi/README.md

@@ -0,0 +1,6 @@
+This folder contains the entitlements needed for the debugger to run on macOS. 
+
+We use the entitlements that the .net runtime uses. See https://github.com/dotnet/runtime/blob/57678512d214af368ff055f358c5106f1aa19ac4/eng/pipelines/common/entitlements.plist
+
+Related Links:
+https://docs.microsoft.com/en-us/dotnet/core/install/macos-notarization-issues#default-entitlements

Build/lldb-mi/debugger-entitlements.plist

@@ -0,0 +1,20 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<!DOCTYPE plist PUBLIC "-//Apple//DTD PLIST 1.0//EN" "http://www.apple.com/DTDs/PropertyList-1.0.dtd">
+<plist version="1.0">
+  <dict>
+    <key>com.apple.security.cs.allow-jit</key>
+      <true/>
+    <key>com.apple.security.cs.allow-unsigned-executable-memory</key>
+      <true/>
+    <key>com.apple.security.cs.allow-dyld-environment-variables</key>
+      <true/>
+    <key>com.apple.security.cs.disable-library-validation</key>
+      <true/>
+    <key>com.apple.security.cs.debugger</key>
+      <true/>
+    <key>com.apple.security.get-task-allow</key>
+      <true/>
+    <key>com.apple.security.task_for_pid-allow</key>
+      <true/>
+  </dict>
+</plist>

Build/lldb-mi/lldb-mi-sign.template.yml

@@ -0,0 +1,30 @@
+---
+parameters:
+  archs: ["x86_64", "arm64"]
+
+jobs:
+- job:
+  pool:
+    name: VSEngSS-MicroBuild2022-1ES
+  steps:
+  - checkout: none
+
+  - ${{ each arch in parameters.archs }}:
+    - task: DownloadPipelineArtifact@1
+      displayName: 'Downloading unsigned_lldb-mi_${{ arch }}'
+      inputs:
+        targetPath: '$(Pipeline.Workspace)/Artifacts' 
+        artifactName: 'unsigned_lldb-mi_${{ arch }}'
+
+    - task: MicroBuildSignMacFiles@1
+      displayName: 'ESRP Sign'
+      inputs:
+        SigningTarget: '$(Pipeline.Workspace)\Artifacts\lldb-mi_${{ arch }}.zip'
+        SigningCert: 8023
+
+    - task: PublishPipelineArtifact@1
+      displayName: 'Publish signed LLDB-MI'
+      inputs:
+        targetPath: '$(Pipeline.Workspace)\Artifacts\lldb-mi_${{ arch }}.zip'
+        artifactName: 'lldb-mi_${{ arch }}_zip'
+...

Build/lldb-mi/lldb-mi.template.yml

@@ -0,0 +1,160 @@
+parameters:
+# Note: Make sure llvm_repo is the same as the one in Extension/cgmanifest.json 
+# 'RepositoryUrl' for llvm-project.
+  llvm_repo: https://github.com/llvm/llvm-project.git
+
+# Note: Make sure llvm_commit is the same as the one in Extension/cgmanifest.json 
+# 'CommitHash' for llvm-project.
+  llvm_commit: 0d44201451f03ba907cdb268ddddfc3fa38a0ebd
+
+  llvm_build_type: Release
+
+  llvm_arch: x86_64
+
+  llvm_additional_parameters: "-DLLDB_USE_SYSTEM_DEBUGSERVER=ON -DLLDB_RELOCATABLE_PYTHON=1 -DLLDB_INCLUDE_TESTS=OFF -DLLDB_BUILD_FRAMEWORK=1"
+
+# Note: Make sure lldb_mi_repo is the same as the one in Extension/cgmanifest.json 
+# 'CommitHash' for lldb-mi.
+  lldb_mi_repo: https://github.com/lldb-tools/lldb-mi.git
+
+# Note: Make sure lldb_mi_commit is the same as the one in Extension/cgmanifest.json 
+# 'CommitHash' for lldb-mi.
+  lldb_mi_commit: 2388bd74133bc21eac59b2e2bf97f2a30770a315
+
+  lldb_mi_additional_parameters: "-DUSE_LLDB_FRAMEWORK=1"
+
+jobs:
+- job: LLDB_MI_${{ parameters.llvm_arch }}
+  timeoutInMinutes: 360
+  pool:
+    ${{if eq(parameters['llvm_arch'], 'arm64')}}:
+      name: cpptoolsMacM1pool
+    ${{ else }}:
+      vmImage: macOS-latest
+  steps:
+  - task: CmdLine@2
+    displayName: 'Install Dependencies'
+    inputs:
+      script: brew install cmake ninja swig
+    continueOnError: true
+
+  - task: CmdLine@2
+    displayName: 'Make sure buildspace does not exist'
+    inputs:
+      script: rm -rf $(Build.StagingDirectory)/buildspace
+    condition: always()
+
+  - task: CmdLine@2
+    displayName: 'Build LLVM Project'
+    inputs:
+      script: |
+        log_and_exec_cmd() {
+          echo "##[command] $1"
+          $1
+        }
+
+        log_and_exec_cmd "sudo rm -rf /Library/Developer/CommandLineTools"
+        log_and_exec_cmd "sudo xcode-select --switch /Applications/XCode.app"
+
+        log_and_exec_cmd "cd $(Build.StagingDirectory)"
+        log_and_exec_cmd "mkdir $(Build.StagingDirectory)/buildspace"
+
+        log_and_exec_cmd "git clone ${{ parameters.llvm_repo }} llvm-project"
+        log_and_exec_cmd "cd llvm-project"
+        log_and_exec_cmd "git checkout ${{ parameters.llvm_commit }}"
+
+        log_and_exec_cmd "./lldb/scripts/macos-setup-codesign.sh"
+
+        log_and_exec_cmd "cd .."
+        log_and_exec_cmd "mkdir $(Build.StagingDirectory)/buildspace/llvm-inst"
+        log_and_exec_cmd "mkdir $(Build.StagingDirectory)/buildspace/llvm-build"
+        log_and_exec_cmd "cd $(Build.StagingDirectory)/buildspace/llvm-build"
+
+        log_and_exec_cmd "cmake -DLLVM_ENABLE_PROJECTS=clang;lldb -DCMAKE_BUILD_TYPE=${{ parameters.llvm_build_type }} -DCMAKE_INSTALL_PREFIX=$(Build.StagingDirectory)/buildspace/llvm-inst/ -DCMAKE_OSX_ARCHITECTURES=${{ parameters.llvm_arch }} ${{ parameters.llvm_additional_parameters }} -GNinja $(Build.StagingDirectory)/llvm-project/llvm"
+        if [[ $? -ne 0 ]]
+        then
+          echo "##[error] cmake llvm failed"
+          cat $(Build.SourcesDirectory)/buildspace/llvm-build/CMakeFiles/CMakeError.log
+          exit 1
+        fi
+
+        log_and_exec_cmd ninja
+        if [[ $? -ne 0 ]]
+        then
+          echo "##[error] ninja failed"
+          exit 1
+        fi
+
+        ### Workaround for https://github.com/llvm/llvm-project/issues/108
+        log_and_exec_cmd "ninja install"
+
+        # Remove conflicting LLDB.framework file.
+        log_and_exec_cmd "rm -rf $(Build.StagingDirectory)/buildspace/llvm-inst/Library/Frameworks/LLDB.framework"
+
+        # Build lldb/sources/API first
+        log_and_exec_cmd "cmake -P $(Build.StagingDirectory)/buildspace/llvm-build/tools/lldb/source/API/cmake_install.cmake"
+        ### End of Workaround
+
+        log_and_exec_cmd "ninja install"
+        if [[ $? -ne 0 ]]
+        then
+          echo "##[error] ninja install failed"
+          exit 1
+        fi
+
+        echo "##[section] Build LLDB-MI"
+        # Download lldb-mi and build it against our custom installation.
+        log_and_exec_cmd "cd $(Build.StagingDirectory)/buildspace"
+        log_and_exec_cmd "git clone ${{ parameters.lldb_mi_repo }} lldb-mi"
+        log_and_exec_cmd "cd lldb-mi"
+        log_and_exec_cmd "git checkout ${{ parameters.lldb_mi_commit }}"
+
+        # Create a separate build directory for building lldb-mi.
+        log_and_exec_cmd "mkdir build"
+        log_and_exec_cmd "cd build"
+        log_and_exec_cmd "cmake -DCMAKE_PREFIX_PATH=$(Build.StagingDirectory)/buildspace/llvm-inst/ -DCMAKE_OSX_ARCHITECTURES=${{ parameters.llvm_arch }} ${{ parameters.lldb_mi_additional_parameters }} -GNinja .."
+        log_and_exec_cmd "ninja"
+        if [[ $? -ne 0 ]]
+        then
+          echo "##[error] ninja failed"
+          exit 1
+        fi
+
+        log_and_exec_cmd "mkdir $(Build.StagingDirectory)/publish"
+        log_and_exec_cmd "cd $(Build.StagingDirectory)/publish"
+
+        log_and_exec_cmd "mkdir -p ./debugAdapters/lldb-mi_${{ parameters.llvm_arch }}/bin"
+
+        log_and_exec_cmd "cp $(Build.StagingDirectory)/buildspace/lldb-mi/build/src/lldb-mi ./debugAdapters/lldb-mi_${{ parameters.llvm_arch }}/bin/."
+
+        # Set rpath for finding LLDB.Framework
+        log_and_exec_cmd "install_name_tool -add_rpath @rpath/LLDB.framework/Versions/A/LLDB ./debugAdapters/lldb-mi_${{ parameters.llvm_arch }}/bin/lldb-mi"
+
+         # Set rpath for App Store XCode LLDB.Framework
+        log_and_exec_cmd "install_name_tool -add_rpath /Applications/Xcode.app/Contents/SharedFrameworks/ ./debugAdapters/lldb-mi_${{ parameters.llvm_arch }}/bin/lldb-mi"
+
+        # Set rpath for XCode CLI LLDB.Framework
+        log_and_exec_cmd "install_name_tool -add_rpath /Library/Developer/CommandLineTools/Library/PrivateFrameworks/ ./debugAdapters/lldb-mi_${{ parameters.llvm_arch }}/bin/lldb-mi"
+
+        # Set rpath next to the lldb-mi executable LLDB.Framework
+        log_and_exec_cmd "install_name_tool -add_rpath @executable_path/. ./debugAdapters/lldb-mi_${{ parameters.llvm_arch }}/bin/lldb-mi"
+
+        # Add entitlements
+        log_and_exec_cmd "codesign -s - -f --entitlements $(Build.SourcesDirectory)/Build/lldb-mi/debugger-entitlements.plist ./debugAdapters/lldb-mi_${{ parameters.llvm_arch }}/bin/lldb-mi"
+
+        # Grab NOTICE.TXT
+        cp $(Build.SourcesDirectory)/Build/lldb-mi/NOTICE.TXT ./debugAdapters/lldb-mi_${{ parameters.llvm_arch }}/.
+
+        zip -r $(Build.StagingDirectory)/lldb-mi_${{ parameters.llvm_arch }}.zip ./debugAdapters
+
+  - task: PublishPipelineArtifact@1
+    displayName: 'Publish LLDB-MI'
+    inputs:
+      targetPath: '$(Build.StagingDirectory)/lldb-mi_${{ parameters.llvm_arch }}.zip'
+      artifactName: 'unsigned_lldb-mi_${{ parameters.llvm_arch }}'
+
+  - task: CmdLine@2
+    displayName: 'Clean up'
+    inputs:
+      script: rm -rf $(Build.StagingDirectory)/buildspace
+    condition: always()

Build/lldb-mi/lldb-mi.yml

@@ -0,0 +1,23 @@
+parameters:
+- name: Build_Type
+  displayName: Build Type
+  type: string
+  default: Release
+
+stages:
+- stage: Build
+  dependsOn: []
+  jobs:
+  - template: lldb-mi.template.yml
+    parameters:
+      llvm_build_type: ${{ parameters.Build_Type }}
+      llvm_arch: x86_64
+  - template: lldb-mi.template.yml
+    parameters:
+      llvm_build_type: ${{ parameters.Build_Type }}
+      llvm_arch: arm64
+
+- stage: Signing
+  dependsOn: ["Build"]
+  jobs:
+  - template: lldb-mi-sign.template.yml

Build/loc/LocProject.json

@@ -0,0 +1,14 @@
+{
+    "Projects": [
+        {
+            "LanguangeSet": "VS_Main_Languages",
+            "LocItems": [
+                {
+                    "SourceFile": "vscode-extensions-localization-export\\vscode-extensions\\vscode-cpptools.xlf",
+                    "Languages": "cs;de;es;fr;it;ja;ko;pl;pt-BR;ru;tr;zh-Hans;zh-Hant",
+                    "LclFile": "Build\\loc\\LCL\\{Lang}\\vscode-cpptools.xlf.lcl"
+                }
+            ]
+        }
+    ]
+}

Build/loc/TranslationsImportExport.yml

@@ -0,0 +1,57 @@
+# ==================================================================================
+# Pipeline for VsCodeExtension-Localization build definition
+# Runs OneLocBuild task to localize xlf file
+# ==================================================================================
+
+resources:
+  repositories:
+  - repository: self
+    clean: true
+
+trigger: none
+pr: none
+schedules:
+- cron: "0 7 * * *"
+  displayName: Daily 7 AM
+  branches:
+    include:
+    - main
+  always: true
+
+pool:
+  name: 'AzurePipelines-EO'
+  demands:
+  - ImageOverride -equals AzurePipelinesWindows2022compliant
+
+steps:
+- task: CmdLine@2
+  inputs:
+    script: 'cd Extension && yarn install'
+
+- task: CmdLine@2
+  inputs:
+    script: 'cd ./Extension && yarn run translations-export && cd ..'
+
+- task: OneLocBuild@2
+  env:
+    SYSTEM_ACCESSTOKEN: $(System.AccessToken)
+  inputs:
+    locProj: 'Build/loc/LocProject.json'
+    outDir: '$(Build.ArtifactStagingDirectory)'
+    isCreatePrSelected: false
+    prSourceBranchPrefix: 'locfiles'
+    packageSourceAuth: 'patAuth'
+    patVariable: '$(OneLocBuildPat)'
+    LclSource: lclFilesfromPackage
+    LclPackageId: 'LCL-JUNO-PROD-VCPP'
+    lsBuildXLocPackageVersion: '7.0.30510'
+
+- task: CmdLine@2
+  inputs:
+    script: 'cd Extension && node ./translations_auto_pr.js microsoft vscode-cpptools csigs $(csigsPat) csigs [email protected] "$(Build.ArtifactStagingDirectory)/loc" vscode-extensions-localization-export/vscode-extensions && cd ..'
+
+- task: PublishBuildArtifacts@1
+  inputs:
+    PathtoPublish: '$(Build.ArtifactStagingDirectory)'
+    ArtifactName: 'drop'
+    publishLocation: 'Container'

CODE_OF_CONDUCT.md

@@ -1,3 +1,9 @@
-## Microsoft Open Source Code of Conduct
+# Microsoft Open Source Code of Conduct
 
-This project has adopted the [Microsoft Open Source Code of Conduct](https://opensource.microsoft.com/codeofconduct/). For more information see the [Code of Conduct FAQ](https://opensource.microsoft.com/codeofconduct/faq/) or contact opencode@microsoft.com with any additional questions or comments.
+This project has adopted the [Microsoft Open Source Code of Conduct](https://opensource.microsoft.com/codeofconduct/).
+
+Resources:
+
+- [Microsoft Open Source Code of Conduct](https://opensource.microsoft.com/codeofconduct/)
+- [Microsoft Code of Conduct FAQ](https://opensource.microsoft.com/codeofconduct/faq/)
+- Contact [[email protected]](mailto:[email protected]) with questions or concerns

CONTRIBUTING.md

@@ -2,19 +2,34 @@
 
 ## Contribution Steps
 
-* [Build and debug the extension](Documentation/Getting%20started.md#build-and-debug-the-cpptools-extension).
+* [Build and debug the extension](Documentation/Building%20the%20Extension.md).
 * File an [issue](https://github.com/Microsoft/vscode-cpptools/issues) and a [pull request](https://github.com/Microsoft/vscode-cpptools/pulls) with the change and we will review it.
 * If the change affects functionality, add a line describing the change to [**CHANGELOG.md**](Extension/CHANGELOG.md).
 * Try and add a test in [**test/extension.test.ts**](Extension/test/unitTests/extension.test.ts).
-* Run tests via opening the [**Extension**](https://github.com/Microsoft/vscode-cpptools/tree/master/Extension) folder in Visual Studio Code, selecting the "Launch Tests" configuration in the Debug pane, and choosing "Start Debugging".
+* Run tests via opening the [**Extension**](https://github.com/Microsoft/vscode-cpptools/tree/main/Extension) folder in Visual Studio Code, selecting the "Launch Tests" configuration in the Debug pane, and choosing "Start Debugging".
 
 ## About the Code
 
 * Execution starts in the `activate` method in [**main.ts**](Extension/src/main.ts).
   * `processRuntimeDependencies` handles the downloading and installation of the OS-dependent files. Downloading code exists in [**packageManager.ts**](Extension/src/packageManager.ts).
   * `downloadCpptoolsJsonPkg` handles the **cpptools.json**, which can be used to enable changes to occur mid-update, such as turning the `intelliSenseEngine` to `"Default"` for a certain percentage of users.
-* The debugger code is in the [**Debugger**](https://github.com/Microsoft/vscode-cpptools/tree/master/Extension/src/Debugger) folder.
+* The debugger code is in the [**Debugger**](https://github.com/Microsoft/vscode-cpptools/tree/main/Extension/src/Debugger) folder.
 * [**LanguageServer/client.ts**](Extension/src/LanguageServer/client.ts) handles various language server functionality.
 * [**LanguageServer/configurations.ts**](Extension/src/LanguageServer/configurations.ts) handles functionality related to **c_cpp_properties.json**.
 * [**telemetry.ts**](Extension/src/telemetry.ts): Telemetry data gets sent to either `logLanguageServerEvent` or `logDebuggerEvent`.
 * The Tag Parser (symbol database) doesn't automatically expand macros, so the [**cpp.hint**](Extension/cpp.hint) file contains definitions of macros that should be expanded in order for symbols to be parsed correctly.
+
+## String Localization
+
+* [vscode-nls](https://github.com/microsoft/vscode-nls) is used to localize strings in TypeScript code.  To use [vscode-nls](https://github.com/microsoft/vscode-nls), the source file must contain:
+```typescript
+import * as nls from 'vscode-nls';
+
+nls.config({ messageFormat: nls.MessageFormat.bundle, bundleFormat: nls.BundleFormat.standalone })();
+const localize: nls.LocalizeFunc = nls.loadMessageBundle();
+```
+* For each user-facing string, wrap the string in a call to localize:
+```typescript
+const readmeMessage: string = localize("refer.read.me", "Please refer to {0} for troubleshooting information. Issues can be created at {1}", readmePath, "https://github.com/Microsoft/vscode-cpptools/issues");
+```
+* The first parameter to localize should be a unique key for that string, not used by any other call to localize() in the file unless representing the same string.  The second parameter is the string to localize.  Both of these parameters must be string literals.  Tokens such as {0} and {1} are supported in the localizable string, with replacement values passed as additional parameters to localize().

Code Samples/BoxConsoleSample/Objects/box.h

@@ -0,0 +1,19 @@
+#ifndef BOX_H
+#define BOX_H
+
+/**
+ * Definition of a box object with three dimensions.
+ */
+struct box
+{
+    int length;
+    int width;
+    int height;
+
+    int volume()
+    {
+        return length * width * height;
+    }
+};
+
+#endif

Code Samples/BoxConsoleSample/README.md

@@ -0,0 +1,24 @@
+# Box Sample
+This sample is a simple C++ program that computes and outputs the volume of a box.
+
+We use this example in our blog posts to illustrate new extension features.
+
+## Build and Debug Active File
+Available as of March 2019, "Build and Debug Active File" automatically configures the build tasks and kicks off a build and debug session. There are
+three ways to get started with this feature.
+
+### Command
+While editing a file in your workspace folder, you can open the command palette and select the `C/C++: Build and Debug Active File` command.
+This option will generate a tasks.json file for you, build your active source file, and then launch the debugger.
+
+![Open command palette and select Build and Debug Active File](build_debug_command.png)
+
+### Context Menu
+While editing a file in a workspace folder, you can right click in the editor field and select the "Build and Debug Active File" context menu option.
+This option will generate a tasks.json file for you, build your active source file, and then launch the debugger.
+
+![Right click and select Build and Debug Active File](build_debug_context_menu.png)
+
+### F5
+Another way to begin building and debugging your active file is to execute the command by pressing <kbd>F5</kbd>. This method will configure
+both a tasks.json and launch.json file for you, build your active source file, and then launch the debugger.

Code Samples/BoxConsoleSample/box_sample.cpp

@@ -0,0 +1,16 @@
+#include <iostream>
+#include "Objects/box.h"
+
+using namespace std;
+
+/**
+ * Calculate and print the volume of a box.
+ */
+int main()
+{
+    box package{ 10, 10, 10 };
+    cout << "Package length: " << package.length << endl;
+    cout << "Package width:  " << package.width << endl;
+    cout << "Package height: " << package.height << endl;
+    cout << "Package volume: " << package.volume() << endl;
+}

Code Samples/Fib/.vscode/tasks.json

@@ -4,7 +4,7 @@
     "version": "2.0.0",
     "tasks": [
         {
-            "taskName": "build",
+            "label": "build",
             "type": "shell",
             "group": {
                 "kind": "build",
@@ -47,4 +47,4 @@
             }
         }
     ]
-}
+}

Code Samples/Fib/README.md

@@ -1,3 +1,3 @@
 # Fib
 
-This code sample is to show debugging. Update `launch.json` and `tasks.json` in the `.vscode` folder to use your setup to build and debug. 
+This code sample is to show debugging. Update `launch.json` and `tasks.json` in the `.vscode` folder to use your setup to build and debug.

Code Samples/Fib/thread.cpp

@@ -15,14 +15,14 @@ static int fib(int n){
     switch (n) {
         case 0: return 1;
         case 1: return 1;
-        default: return (fib(n-2) + fib(n-1)); 
-    }    
+        default: return (fib(n-2) + fib(n-1));
+    }
 }
 
 void * thread_proc(void* ctx)
 {
     int tid = g_tid++;
-    
+
     char thread_name[16];
     sprintf(thread_name, "Thread %d", tid);
 #ifdef __APPLE__
@@ -30,19 +30,19 @@ void * thread_proc(void* ctx)
 #else
     pthread_setname_np(pthread_self(), thread_name);
 #endif
-    
+
     // Random delay, 0 - 0.5 sec
     timespec ts;
     ts.tv_sec = 0;
     ts.tv_nsec = 500000000 + ((float)rand() / (float)RAND_MAX) * 500000000;
     nanosleep(&ts, NULL);
-    
+
     volatile int i = 0;
     while (i <= 30) {
         std::cout << "Thread " << tid << ": fib(" << i << ") = " << fib(i) << std::endl;
         i++;
         nanosleep(&ts, NULL);
     }
-    
+
     std::cout << thread_name << " exited!" << std::endl;
 }

Code Samples/SampleClangProject/.gitignore

@@ -1,2 +0,0 @@
-main.exe
-main.exe.dSYM

Code Samples/SampleClangProject/.vscode/launch.json

@@ -1,17 +0,0 @@
-{
-    "version": "0.2.0",
-    "configurations": [
-        {
-            "name": "(lldb) Launch",
-            "type": "cppdbg",
-            "request": "launch",
-            "program": "${workspaceRoot}/main.exe", // this is executable to launch the debugger with
-            "args": ["YourNameHere"],
-            "stopAtEntry": true, // if true then stop at the main entry (function)
-            "cwd": "${workspaceRoot}",
-            "environment": [],
-            "externalConsole": true,
-            "MIMode": "lldb"
-        }
-    ]
-}

Code Samples/SampleClangProject/.vscode/tasks.json

@@ -1,19 +0,0 @@
-{
-    // See https://go.microsoft.com/fwlink/?LinkId=733558
-    // for the documentation about the tasks.json format
-    "version": "2.0.0",
-    "tasks": [
-        {
-            "label": "clang++",
-            "command": "clang++ --debug -o main.exe main.cpp",
-                // "--debug" enables debugging symbols
-                // "-o main.exe" specifies the output executable
-                // "main.cpp" is the source file to compile
-            "type": "shell",
-            "group": {
-                "kind": "build",
-                "isDefault": true
-            }
-        }
-    ]
-}

Code Samples/SampleClangProject/README.md

@@ -1,10 +0,0 @@
-# README
-This is a sample debuggable C++ project. It uses the vendor provided version of clang installed. `tasks.json` and `launch.json` have been edited to demonstrate how to create a configuration for a C++ project that builds with clang.
-
-There's a sample build task in `.vscode/tasks.json`; you can also see the build configurations by using the menu option `Configure` -> `Configure Tasks` or by clicking the gear icon in the Debug Panel.
-
-To run a build, use the menu option `Tasks` -> `Run Build Task...`.
-
-There's a sample debug configuration in `.vscode/launch.json`; you can also see the configuration by using the menu option `Debug` -> `Open Configurations`.
-
-To debug the build, use the menu option `Debug` -> `Start Debugging`. The executable will launch and stop in the main function.

Code Samples/SampleClangProject/main.cpp

@@ -1,17 +0,0 @@
-#include <iostream>
-#include <string>
-
-using namespace std;
-
-void greet(const string& person) {
-    cout << "Hello, " << person << "!" << endl;
-}
-
-int main(int argc, char** argv) {
-    if(argc >= 2) {
-        greet(argv[1]);
-    } else {
-        cerr << "insufficient args, usage: " << argv[0] << " personNameHere" << endl;
-    }
-    return 0;
-}

Documentation/Building the Extension.md

@@ -1,14 +1,23 @@
-## How to build and debug the Microsoft CppTools Extension  
-  
-These steps will allow you to debug the TypeScript code that is part of the Microsoft CppTools extension for Visual Studio Code.  
-  
-Prerequisite steps:  
-  * Clone [this](https://github.com/Microsoft/vscode-cpptools) repository.  
-  * Install [npm](https://nodejs.org).  
-  * From a command line, run the following commands from the **Extension** folder in the root of the repository:  
-      * `npm install -g vsce` will install `vsce` globally to create the vsix package.  
-      * `npm install` will install the dependencies needed to build the extension.  
-  * Set an environment variable `CPPTOOLS_DEV=1`.  
-    * This enables the local developer workflow, copying dependencies from the **node_modules** folder.  
-  * Open the **Extension** folder in Visual Studio Code and F5.  
-  * Read the [contributing guidelines](https://github.com/Microsoft/vscode-cpptools/blob/master/CONTRIBUTING.md).  
+## How to build and debug the Microsoft CppTools Extension
+
+These steps will allow you to debug the TypeScript code that is part of the Microsoft CppTools extension for Visual Studio Code.
+
+Prerequisite steps:
+  * Clone the release branch of [this](https://github.com/Microsoft/vscode-cpptools) repository.
+      * git clone -b release https://github.com/Microsoft/vscode-cpptools
+  * Install [node](https://nodejs.org).
+  * Install [yarn](https://yarnpkg.com).
+  * From a command line, run the following commands from the **Extension** folder in the root of the repository:
+      * `yarn install` will install the dependencies needed to build the extension.
+      * **(optional)** `yarn global add vsce` will install `vsce` globally to create a VSIX package that you can install.
+  * Open the **Extension** folder in Visual Studio Code and press F5. This will launch a VS Code Extension Host window and activate the TypeScript debugger. You can set breakpoints on the extension source code and debug your scenario.
+      * If, after pressing F5, you see the following error in the `[Extension Development Host]` window,
+      > Unable to start the C/C++ language server. IntelliSense features will be disabled. Error: Missing binary at .../vscode-cpptools/Extension/bin/cpptools
+      * Then, you can follow the instructions in this [comment in a discussion about building this extension locally](https://github.com/microsoft/vscode-cpptools/discussions/8745#discussioncomment-2091563).
+        > get the <package.version.number> binaries from installing the extension and then copying the binaries
+        1. To do this, install this extension from the Visual Studio Marketplace and find its location on your device. It might be in a directory like `\\wsl$\Ubuntu\home\hamir\.vscode-server\extensions\ms-vscode.cpptools-<package.version.number>`, for example.
+        2. Next, go to the `bin/` directory of the aforementioned directory, and drag-and-drop, or copy-and-paste, `cpptools` and `cpptools-srv` from `...\extensions\ms-vscode.cpptools-<package.version.number>\bin\` to this repository's `Extension\bin\` directory on your local device, so that `.../vscode-cpptools/Extension/bin/cpptools` and `.../vscode-cpptools/Extension/bin/cpptools-srv` both exist in your workspace.
+        3. The aforementioned warning should be gone, and Intellisense, which gives those squiggly red error lines, should now be present.
+        4. The `insiders` branch has binaries compatible with the latest Pre-Release version of the extension, and the `release` branch has binaries compatible with the latest Release version, but the `main` branch may have TypeScript changes that are incompatible with the published binaries, in which case, you'll need to create a branch off the `insiders` or `release` branches.
+
+      * Feel free to use [the Discussions tab of this repository](https://github.com/microsoft/vscode-cpptools/discussions) if you have any further questions on building this extension locally.

Documentation/Debugger/ExceptionSettings.md

@@ -0,0 +1,20 @@
+# Exception Settings
+
+The Microsoft Windows C/C++ debugger (cppvsdbg) supports configuration options for if the debugger stops when exceptions are thrown. This is done with the 'All Exceptions' check box in the BREAKPOINTS section of the 'Run and Debug' view.
+
+Note that the BREAKPOINTS section will be missing this entry until the first time that the folder has been debugged with the 'cppvsdbg' debugger.
+
+Checking 'All Exceptions' will configure the debugger to stop when an exception is thrown.
+
+##### Exception Conditions
+
+The 'All Exceptions' checkbox support conditions to break on only selected exception types (C++ exceptions) or codes (Win32 exceptions). To edit the condition, click on the pencil icon or right click on the entry and invoke 'Edit Condition'. The condition is a comma-separated list of exception types and codes to break on, or if the list starts with '!', a list of exception types and codes to ignore.
+
+Examples conditions:
+
+| Example condition value | Result |
+|-------------------------|--------|
+| 0xC0000005, 0xC0000094 | Break on Win32 Access Violation exceptions and integer division by zero exceptions |
+| std::out_of_range, 0xC0000005 | This will break on out-of-range exceptions, and access violation exceptions |
+| !MyExceptionClass | This will break on all exceptions except C++ `MyExceptionClass` exceptions |
+| !MyExceptionClass, 0x6831C815 | This will break on all exceptions except C++ `MyExceptionClass` exceptions and Win32 exceptions with custom code 0x6831C815 |

Documentation/Debugger/How To Debug MIEngine.md

@@ -1,8 +1,6 @@
-# How To Debug MIEngine (Work in Progress)
+# How To Debug MIEngine
 
-*This is a work in progress. Please create a pull request with updates if there is anything wrong with it.*
-
-MIEngine is one of the components used to enable the C/C++ debugging scenario with the Microsoft C/C++ extension with VS Code. This document is to help enable users who want to debug and contribute to MIEngine to fix issues or extend functionality. MIEngine is used to communicate with `gdb`/`lldb` using the MI protocol. 
+MIEngine is one of the components used to enable the C/C++ debugging scenario with the Microsoft C/C++ extension with VS Code. This document is to help enable users who want to debug and contribute to MIEngine to fix issues or extend functionality. MIEngine is used to communicate with `gdb`/`lldb` using the MI protocol.
 
 **Repository:** https://github.com/Microsoft/MIEngine
 
@@ -15,39 +13,52 @@ You can open the solution file **MIDebugEngine.sln** located under **src** and c
 * Microsoft.MICore.dll
 * Microsoft.MICore.XmlSerializers.dll
 * Microsoft.MIDebugEngine.dll
+* vscode\OpenDebugAD7.exe
+* vscode\Microsoft.DebugEngineHost.dll
+* vscode\Microsoft.VisualStudio.Shared.VSCodeDebugProtocol.dll
 
 The symbol files are as follows:
 
-**On Windows** 
+**On Windows**
 * Microsoft.MICore.pdb
-* Microsoft.MIDebugEngine.dll
+* Microsoft.MIDebugEngine.pdb
+* vscode\OpenDebugAD7.pdb
+* vscode\Microsoft.DebugEngineHost.pdb
 
 **On Linux/Mac**
 * Microsoft.MICore.dll.mdb
 * Microsoft.MIDebugEngine.dll.mdb
+* vscode\OpenDebugAD7.exe.mdb
+* vscode\Microsoft.DebugEngineHost.dll.mdb
 
 ### Debugging On Windows
 
-On Windows, the easiest way to debug is to use Visual Studio. Locate the **package.json** file in the **Extension** folder and open it in an editor.
+On Windows, the easiest way to debug is to use Visual Studio. Locate the **src\Debugger\extension.ts** file in the **Extension** folder and open it in an editor.
 
-Locate the following line: 
+If you are not building the extension, Locate the **out\src\Debugger\extension.ts** file in the **.vscode\extensions\ms-vscode.cpptools** folder and open it in an editor.
+
+Locate the following lines:
 ```json
-"program": "./debugAdapters/OpenDebugAD7",
+return {
+    command: command
+};
 ```
-and add the following line below it:
+and add the following line to the object:
 ```json
-"args": ["--pauseForDebugger"],
+args: ["--pauseForDebugger"]
 ```
 
-This will cause the debugger to look like it has hung once you start debugging, but in reality it is waiting for a debugger to attach. Set your breakpoints and attach your debugger to the `OpenDebugAD7.exe` process. Once the debugger is attached, VS Code should start debugging and you can reproduce your scenario. 
+This will cause the debugger to look like it has hung once you start debugging, but in reality it is waiting for a debugger to attach. Set your breakpoints and attach your debugger to the `OpenDebugAD7.exe` process. Once the debugger is attached, VS Code should start debugging and you can reproduce your scenario.
 
-### Debugging MIEngine running on Linux or Mac OS X
+### Debugging MIEngine running on Linux or macOS
 
-On Linux and Mac OS X, we use `mono` as our framework. You can download Xamarin Studio v5.10.1.6 and remotely attach to your Mac or Linux box to debug there.
+#### With MonoDevelop
 
-#### Install Prerequisites
-1. Install [GTK](http://www.mono-project.com/download/)
-2. Install [Xamarin Studio v5.10.1.6](http://download.xamarin.com/studio/Windows/XamarinStudio-5.10.1.6-0.msi)
+On Linux and macOS, we use `mono` as our framework. You can download Xamarin Studio v5.10.1.6 and remotely attach to your Mac or Linux box to debug there.
+
+##### Install Prerequisites
+1. Install [GTK](http://www.mono-project.com/download/).
+2. Install [Xamarin Studio v5.10.1.6](http://download.xamarin.com/studio/Windows/XamarinStudio-5.10.1.6-0.msi).
 
 Remote attach functionality behind a flag.  You can run it like this:
 ```PowerShell
@@ -56,26 +67,60 @@ set MONODEVELOP_SDB_TEST=1
 MonoDevelop.exe
 ```
 
-#### Create an empty project for attaching (one-time setup)
+##### Create an empty project for attaching (one-time setup)
 
-1. Launch MonoDevelop
-2. File -> New Solution
-3. Misc/Generic Project
-4. Name project and hit "Create"
-5. Right-click the project node (blue square) and do "Options"
+1. Launch MonoDevelop.
+2. File -> New Solution.
+3. Misc/Generic Project.
+4. Name project and hit "Create".
+5. Right-click the project node (blue square) and do "Options".
 6. Under Run -> Custom Commands, select "Execute" in the lower dropdown and choose a command (I use `c:\windows\notepad.exe` - it doesn't matter what the command is, but MonoDevelop requires it to exist before it'll light up the Run menu).
 
-#### Configure the extension to enable remote debugging
+##### Configure the extension to enable remote debugging
 
-Open the **~/.vscode/extensions/ms-vscode.cpptools-\<version\>/debugAdapters/OpenDebugAD7** file with a text editor and locate and uncomment the line at the bottom. When you start debugging, it will now hang until the remote debugger is attached from Xamarin Studio. 
+Open the **~/.vscode/extensions/ms-vscode.cpptools-\<version\>/debugAdapters/OpenDebugAD7** file with a text editor and locate and uncomment the line at the bottom. When you start debugging, it will now hang until the remote debugger is attached from Xamarin Studio.
 
-#### Attach the remote debugger
+##### Attach the remote debugger
 
-In MonoDevelop: Run -> Run With -> Custom Command Mono Soft Debugger
-Fill in the IP and port of the Linux/Mac OS X machine and hit "Connect" to start debugging
+In MonoDevelop: Run -> Run With -> Custom Command Mono Soft Debugger.
+Fill in the IP and port of the Linux/macOS machine and hit "Connect" to start debugging.
 
 After you've done this once, you can hit the MonoDevelop "Play" button or <kbd>F5</kbd> to bring up the connect dialog again.
 
-Note: If you are debugging to CentOS, you will need to make an exception in the firewall
+#### With VS Code + Mono Debug
+
+##### Install Prerequisites
+1. Install [VS Code](https://code.visualstudio.com/Download).
+2. Install Mono Debug extension for VS Code.
+
+##### Create an empty project (one-time setup)
+1. Open to a new folder and create `.vscode/launch.json`.
+2. Create the following configuration in launch.json.
+```
+{
+    "version": "0.2.0",
+    "configurations": [
+        {
+            "name": "Attach to Mono",
+            "request": "attach",
+            "type": "mono",
+            "address": "<INSERT_MACHINE_IP_ADDRESS_HERE>",
+            "port": 1234
+        }
+    ]
+}
+```
+
+##### Configure the extension to enable remote debugging
+
+Open the **~/.vscode/extensions/ms-vscode.cpptools-\<version\>/debugAdapters/OpenDebugAD7** file with a text editor and locate and uncomment the line at the bottom. When you start debugging, it will now hang until the remote debugger is attached from VS Code.
+
+##### Attach the remote debugger
+
+Select the `Attach to Mono` configuration and hit F5.
+
+#### Additional Notes
+
+Note: If you are debugging to CentOS, you will need to make an exception in the firewall.
 * `sudo firewall-cmd --zone=public --add-port=1234/tcp --permanent`
 * `sudo firewall-cmd --reload`

Documentation/Debugger/gdb/PipeTransport.md

@@ -1,54 +1 @@
-# Pipe Transport
-
-Pipe Transport allows communication through a pipe program to a remote shell. An example on Linux would be `ssh`.
-
-## How-To
-
-We have added `"pipeTransport"` as an option within the **launch.json** file. The structure looks as follows:
-```json
-"pipeTransport": {
-    "pipeCwd": "/usr/bin",
-    "pipeProgram": "/usr/bin/ssh",
-    "pipeArgs": [
-        "-pw",
-        "<password>",
-        "[email protected]"
-    ],
-    "debuggerPath": "/usr/bin/gdb"
-},
-```
-The `pipeArgs` can be any set of arguments necessary to setup and authenticate the pipe connection. In the example, a password is used but you can also use an ssh key.
-
-You may also need to add a `sourceFileMap` to map the path of where the code exists on the remote shell to where it is locally:
-```json
-"sourceFileMap": {
-    // "remote": "local"
-    "/home/user/src": "/src/projectA/src"
-}
-```
-
-## Attach
-
-You can also use the above `pipeTransport` block to attach to a remote process. In the attach case, you will need to specify a `processId`. We have added the ability to query processes from the remote machine. To do this, change `"processId": "${command.pickProcess}"` to `"processId": "${command.pickRemoteProcess}"`. The `pipeTransport` settings will be used to query the processes on the remote machine. Then select the process from the drop down list. As with `launch`, you may need to configure `sourceFileMap`. 
-
-## Docker example
-
-The `pipeTransport` can also be used to debug a process in a Docker container. For an attach, **launch.json** will include:
-
-```json
-"pipeTransport": {
-    "pipeCwd": "${workspaceRoot}",
-    "pipeProgram": "docker",
-    "pipeArgs": [
-        "exec", 
-        "-i", 
-        "hello_gdb", 
-        "sh",
-        "-c"
-    ],
-    "debuggerPath": "/usr/bin/gdb"
-},
-```
-Where `hello_gdb` is the name of your container.
-
-Launching a process is accomplished by starting a container and then using the same `pipeTransport` launch additional processes in the container. See this [**launch.json**](https://github.com/andyneff/hello-world-gdb/blob/master/.vscode/launch.json) for a [full example](https://github.com/andyneff/hello-world-gdb/).
+The documentation for pipe transport has moved to https://code.visualstudio.com/docs/cpp/pipe-transport.

Documentation/Debugger/gdb/Windows Subsystem for Linux.md

@@ -1,91 +1 @@
-# Windows 10's Windows Subsystem for Linux
-
-With the release of Windows 10 Creators Update (Build 15063), you will now be able to use Visual Studio Code and the Microsoft C/C++ extension to debug your [Windows Subsystem for Linux (WSL)](https://msdn.microsoft.com/en-us/commandline/wsl/about) projects.
-
-Code can be written on Windows itself using VSCode and debugged through `bash.exe` to the Bash on Windows layer.
-
-As of the Fall Creator's Update, you can have multiple distros installed, but `bash.exe` and `wsl.exe` use the default distro. Use [WSL Config](https://msdn.microsoft.com/en-us/commandline/wsl/wsl-config) to set your default distro.
-
-**NOTE: Creator's Update (Build 15063 or later) is required due to bug-fixes within the subsystem that we rely on to provide debugging. Debugging using a previous version of WSL is unsupported and likely will not work. To check your Windows version, enter `winver` in a command prompt.**
-
-## Prerequisites
-
-* [Windows 10 Creators Update or later with Windows Subsystem for Linux](https://msdn.microsoft.com/en-us/commandline/wsl/install_guide) installed.
-* Install g++/gcc and gdb within `WSL` to allow compiling and debugging. You can use the package manager to do this. For example, to install g++, you can run `sudo apt install g++` in the Bash window.
-* [Visual Studio Code](https://code.visualstudio.com) + Microsoft C/C++ extension for VSCode.
-
-## How-To
-
-To debug, commands will be routed from Windows through `bash.exe` to set up debugging. Because our extension runs as a 32-bit process, it will need to use the `C:\Windows\SysNative` folder to access the `bash.exe` executable that is normally in `C:\Windows\System32`. We will be using the `"pipeTransport"` ability within the extension to do debugging and `"sourceFileMap"` to map the source from the subsystem's paths back to Windows path.
-
-**NOTE: Applications will need to be compiled in the `Windows Subsystem for Linux (WSL)` prior to debugging.**
-
-### Example `launch.json` for Launching
-
-In the following example, I have a local drive, `Z:\` that has my source code within windows for an app called _kitchensink_. I have set up the `"program"` and `"cwd"` paths to point to the directory within `WSL`. I have set up the `"pipeTransport"` to use `bash.exe`. I have also set up a `"sourceFileMap"` to have everything that is returned by `gdb` that starts with `/mnt/z` to point to `Z:\\` in Windows.
-
-```json
-{
-    "name": "C++ Launch",
-    "type": "cppdbg",
-    "request": "launch",
-    "program": "/mnt/z/Bash/kitchensink/a.out",
-    "args": ["-fThreading"],
-    "stopAtEntry": false,
-    "cwd": "/mnt/z/Bash/kitchensink",
-    "environment": [],
-    "externalConsole": true,
-    "windows": {
-        "MIMode": "gdb",
-        "setupCommands": [
-            {
-                "description": "Enable pretty-printing for gdb",
-                "text": "-enable-pretty-printing",
-                "ignoreFailures": true
-            }
-        ]
-    },
-    "pipeTransport": {
-        "pipeCwd": "",
-        "pipeProgram": "c:\\windows\\sysnative\\bash.exe",
-        "pipeArgs": ["-c"],
-        "debuggerPath": "/usr/bin/gdb"
-    },
-    "sourceFileMap": {
-        "/mnt/z": "z:\\"
-    }
-}
-```
-
-### Example `launch.json` for Attaching to an Existing Process
-
-This configuration similar to the launch process above. I have chosen to start the same application above from the Bash command line and now I want to attach to it for debugging. I have changed the `"processID"` to use the remote process picker by specifying the command `"${command:pickRemoteProcess}"` and set up the same `"sourceFileMap"`. When I press <kbd>F5</kbd> to attach, I get a picker drop down showing the running processes within `WSL`. I can scroll or search for the process I want to attach to and start debugging.
-
-```json
-{
-    "name": "C++ Attach",
-    "type": "cppdbg",
-    "request": "attach",
-    "program": "/mnt/z/Bash/kitchensink/a.out",
-    "processId": "${command:pickRemoteProcess}",
-    "windows": {
-        "MIMode": "gdb",
-        "setupCommands": [
-            {
-                "description": "Enable pretty-printing for gdb",
-                "text": "-enable-pretty-printing",
-                "ignoreFailures": true
-            }
-        ]
-    },
-    "pipeTransport": {
-        "pipeCwd": "",
-        "pipeProgram": "c:\\windows\\sysnative\\bash.exe",
-        "pipeArgs": ["-c"],
-        "debuggerPath": "/usr/bin/gdb"
-    },
-    "sourceFileMap": {
-        "/mnt/z": "z:\\"
-    }
-}
-```
+The documentation for GCC on Windows Subsystem for Linux (WSL) has moved to https://code.visualstudio.com/docs/cpp/config-wsl.

Documentation/Debugger/natvis/Natvis.md

@@ -1,15 +1 @@
-# Natvis - Custom views for native objects
-
-The Natvis framework allows developers to write custom schemas to help visualize native objects.
-
-For gdb/lldb debugging (`"type": "cppdbg"`), a subset of the Natvis framework has been ported to the C/C++ extension and the code resides in the [MIEngine](https://github.com/Microsoft/MIEngine) shared component. If additional features that are not implemented are requested, please file an [issue](https://github.com/Microsoft/MIEngine/issues) on the MIEngine GitHub page with details of what is missing.
-
-For Visual C++ debugging (`"type": "cppvsdbg"`), the debugger contains the full implementation of the Natvis framework as Visual Studio.
-
-## Documentation
-
-The official documentation can be found [here](https://docs.microsoft.com/en-us/visualstudio/debugger/create-custom-views-of-native-objects).
-
-## Schema
-
-The Natvis schema can be found [here](natvis.xsd).
+The documentation for Natvis has moved to https://code.visualstudio.com/docs/cpp/natvis.

Documentation/Debugger/natvis/natvis.xsd

@@ -240,7 +240,7 @@
       </xs:annotation>
     </xs:attribute>
   </xs:complexType>
-  
+
   <!-- Attributes for elements that support filtering by view-->
   <xs:attributeGroup name="ViewConstraints">
     <xs:attribute name="IncludeView" type ="ViewIncludeType" use="optional" />
@@ -335,9 +335,9 @@
         are evaluated in the context of the node.
       </xs:documentation>
     </xs:annotation>
-  </xs:attribute>    
+  </xs:attribute>
   </xs:attributeGroup>
-  
+
   <xs:complexType name="ListItemsNodeType">
     <xs:annotation>
       <xs:documentation>Expression that points to value of the linked list node. It can be left empty or have 'this' to refer to the linked list node itself. This expression is evaluated under the context of the linked list node and not the parent linked list type.</xs:documentation>
@@ -402,7 +402,7 @@
           <xs:documentation>
             Indicates that the item should use the icon associated with general data.
           </xs:documentation>
-        </xs:annotation>        
+        </xs:annotation>
       </xs:enumeration>
       <xs:enumeration value="Method">
         <xs:annotation>
@@ -864,16 +864,16 @@
   <xs:complexType name="MostDerivedObjectType">
     <xs:annotation>
       <xs:documentation>
-        Specifies an expression which evaluates to the current object, casted to its most-derived type.  
-        
-        In most cases, the debugger is able to automatically determine an object's most-derived type, in which case use of the &lt;MostDerivedType&gt; 
+        Specifies an expression which evaluates to the current object, casted to its most-derived type.
+
+        In most cases, the debugger is able to automatically determine an object's most-derived type, in which case use of the &lt;MostDerivedType&gt;
         element is unecessary.  Automatic determination of an object's most-derived type requires the object to be an instance of a C++ class, with a
         compiler-generated virtual function table.  This is sufficient for most class-hierarchies; however, custom logic may occasionally be necessary
-        when dealing with a class hierarchy that does not contain virtual functions, or when the virtual function table is manually constructed by the 
+        when dealing with a class hierarchy that does not contain virtual functions, or when the virtual function table is manually constructed by the
         application code.
       </xs:documentation>
     </xs:annotation>
-    
+
     <xs:simpleContent>
       <xs:extension base="StringType">
         <xs:attributeGroup ref="CommonAttributes" />
@@ -935,12 +935,12 @@
     <xs:annotation>
       <xs:documentation>
         Indicates that the given type is a smart pointer.  The text inside this element specifies the expression to evaluate the underlying pointer.
-        
+
         The &lt;SmartPointer&gt; element has the following effects:
           - If no alternative &lt;DisplayString&gt; element is provided (or all &lt;DisplayString&gt; elements have failed conditions), the underlying pointer will be the display string
           - If no alternative &lt;StringView&gt; element is provided (or all &lt;StringView&gt; elements have failed conditions), the underlying pointer will be the string view, if it has one.
           - If no alternative &lt;Expand&gt; element is provided, the expansion of the smart pointer will be the expansion of the underlying pointer.
-          - The smart pointer class will also support overloaded operators as determined by the &lt;Usage&gt; attribute.  You can opt out of this behavior by specifying 
+          - The smart pointer class will also support overloaded operators as determined by the &lt;Usage&gt; attribute.  You can opt out of this behavior by specifying
               'DefaultExpansion=&quot;false&quot;'
       </xs:documentation>
     </xs:annotation>
@@ -949,7 +949,7 @@
         <xs:attributeGroup ref="CommonAttributes_NoCondition" />
         <xs:attribute name="Usage" type="SmartPointerUsage" use="required">
           <xs:annotation>
-            <xs:documentation>Indicates which combinations of operators this smart pointer object supports.              
+            <xs:documentation>Indicates which combinations of operators this smart pointer object supports.
             </xs:documentation>
           </xs:annotation>
         </xs:attribute>
@@ -1004,10 +1004,10 @@
       <xs:documentation>Specifies an optional priority to assign to this entry for type matching. Higher priority entries within a particular file or directory
       are checked first.  &lt;Type&gt; entries that do not specify a priority receive default priority of &quot;Medium&quot;  &lt;AlternativeType&gt; entries which do not specify a priority
       will inherit the priority of the enclosing &lt;Type&gt; element.  The priority is only used to disambiguate type matching when all other means of disambiguation are unavailable.
-      For example, entries with more specific template instantiations, module constraints, or view constraints will take priority regardless of any priority values specified.  
-      Similarly, regardless of priority, natvis files that are part of a loaded project will always take precedence over files in the user natvis directory, 
-      which will, in turn, take precedence over files in the system-wide natvis directory.   
-      
+      For example, entries with more specific template instantiations, module constraints, or view constraints will take priority regardless of any priority values specified.
+      Similarly, regardless of priority, natvis files that are part of a loaded project will always take precedence over files in the user natvis directory,
+      which will, in turn, take precedence over files in the system-wide natvis directory.
+
       If two entries have the same priority and cannot otherwise be disambiguated, it is unspecified which one will get used.
       </xs:documentation>
     </xs:annotation>

Documentation/FAQs.md

@@ -1,45 +1 @@
-# FAQs
-
-## Table of Contents
-* Setup: [Debugging Setup](#debugging-setup)
-* Debugger: [Why is debugging not working?](#why-is-debugging-not-working)
-* Build: [How to enable debug symbols?](#how-to-enable-debug-symbols)
-
-## Debugging Setup
-The debugger needs to be configured to know which executable and debugger to use:
-
-Click menu item: `Debug` -> `Add Configuration...`
-
-The file **launch.json** will now be open for editing with a new configuration. The default settings will *probably* work except that you need to specify the **program** setting.
-
-See the [**Documentation/Debugger**](https://github.com/Microsoft/vscode-cpptools/tree/master/Documentation/Debugger) folder in this repository for more in-depth documentation on how to configure the debugger.
-
-## Why is debugging not working?
-
-### My breakpoints aren't being hit
-
-When you start debugging, if it is showing that your breakpoints aren't bound (solid red circle) or they are not being hit, you may need to enable [debug symbols](#how-to-enable-debug-symbols) during compilation. 
-
-### Debugging starts but all the lines in my stack trace are grey
-
-If your debugger is showing a grey stacktrace or won't stop at a breakpoint,or the symbols in the call stack are grey then your executable was compiled without [debug symbols](#how-to-enable-debug-symbols).
-
-## How to enable debug symbols?
-
-Enabling debug symbols are dependent on the type of compiler you are using. Below are some of the compilers and the compiler options necessary to enable debug symbols.
-
-When in doubt, please check your compiler's documentation for the options necessary to include debug symbols in the output. This may be some variant of `-g` or `--debug`.
-
-* #### Clang (C++)
-  * If you invoke the compiler manually then add the `--debug` option.
-  * If you're using a script then make sure the `CXXFLAGS` environment variable is set; e.g. `export CXXFLAGS="${CXXFLAGS} --debug"`
-  * If you're using CMake then set make sure the `CMAKE_CXX_FLAGS` is set; e.g. `export CMAKE_CXX_FLAGS=${CXXFLAGS}`
-
-* #### Clang (C)
-  See Clang C++ but use `CFLAGS` instead of `CXXFLAGS`.
-
-* #### gcc or g++
-  If you invoke the compiler manually, add the `-g` option.
-
-* #### cl.exe
-  Symbols are located in the `*.pdb` file.
+The FAQs for the C/C++ extension has moved to https://code.visualstudio.com/docs/cpp/faq-cpp.

Documentation/Getting started with IntelliSense configuration.md

@@ -1,56 +1,3 @@
+This file is deprecated.
 
-# Configuring includePath for better IntelliSense results
-
-This page describes how to configure include paths for folders containing C or C++ files to get the full IntelliSense experience. If you're seeing the following message when opening a folder in VS Code, it means the C++ IntelliSense engine needs additional information about the paths in which your include files are located.
-
-![Configure includePath for better IntelliSense](https://github.com/Microsoft/vscode-cpptools/raw/master/Images/configure%20includepath.jpg)
-
-## Where are the include paths defined?
-
-The include paths are defined in the `"includePath"` setting in a file called **c_cpp_properties.json** located in the **.vscode** directory in the opened folder.
-
-You can create or open this file by either using the `"C/Cpp: Edit Configurations"` command in the command palette or by selecting `"Edit "includePath" setting"` in the lightbulb menu (see the screenshot below). The quickest way to locate a lightbulb is to scroll to the top of the source file and click on any green squiggle that shows up under a #include statement.
-
-![lightbulb menu "Edit "includePath" setting"](https://github.com/Microsoft/vscode-cpptools/raw/master/Images/Lightbulb.png)
-
- When a folder is opened, the extension attempts to locate your system headers based on your operating system, but it does not know about any other libraries that your project depends on. You can hover over the green squiggles or open the Problems window to understand which headers the IntelliSense engine is unable to open - sometimes it's the dependent headers that can't be located.
-
-![include error message](https://github.com/Microsoft/vscode-cpptools/raw/master/Images/Include%20errors.png)
-
-## How to specify the include paths?
-
-You can specify the remaining paths using one of the techniques described below.
-
-#### 1. Use `compile_commands.json` file to supply includePaths and defines information
-
-The extension can get the information for `"includePath"` and `"defines"` from a **compile_commands.json** file, which can be auto-generated by many build systems such as CMake and Ninja. Look for the section where your current configuration is defined (by default there's one configuration per OS, such as "Win32 or "Mac"), and set the `"compileCommands"` property in **c_cpp_properties.json** to the full path to your **compile_commands.json** file and the extension will use that instead of the `"includes"` and `"defines"` properties for IntelliSense.
-
-![use compileCommands setting](https://github.com/Microsoft/vscode-cpptools/raw/master/Images/compile_commands.png)
-
-#### 2. Use the lightbulb suggestions to auto-resolve includePath
-
-The first thing to try is to leverage the lightbulb path suggestions to auto-resolve the include paths. When you open a folder, the extension will **recursively** search for potential include paths that match the header files your code is using based on the paths set by the `"browse.path"` setting in **c_cpp_properties.json**. Click on the green squiggles under #include statements and you'll see a lightbulb offering suggestions of paths that will allow IntelliSense to resolve the included file.
-
-![lightbulb suggestions](https://github.com/Microsoft/vscode-cpptools/raw/master/Images/lightbulb%20suggestion.png)
-
-If you don't see path suggestions in the lightbulb, try adding the root folder where the headers are likely located in to the `"browse.path"` setting in **c_cpp_properties.json**. This allows the extension to **recursively** search in these folders and offer more suggestions in the lightbulb as the search process goes on.
-
-#### 3. Manually add include paths
-If none of the above fully resolves the paths, you could manually specify the paths to the headers that your project depends on in the **c_cpp_properties.json** file.  Look for the section where your current configuration is defined (by default there's one configuration per OS, such as "Win32 or "Mac"), and add your paths in the `"includePath"` setting and defines in the `"defines"` setting. For example, the following screenshot shows a snippet of the file specifying path for the Mac configuration.
-
-![c_cpp_properties file snippet](https://github.com/Microsoft/vscode-cpptools/raw/master/Images/c_cpp_properties%20file.PNG)
-
-## Verify the include paths are correctly resolved
-
-There are two ways to verify that the include paths are correctly resolved:
-
-1. The green squiggles in the source file are no longer showing
-2. Error messages are cleared in the Problems window
-
-This indicates that the IntelliSense engine has got the include paths resolved so you can start enjoying the full IntelliSense for your C or C++ code for the current translation unit. Note that you may still see errors on other files if they belong to a different translation unit that requires additional include paths to be configured.
-
-## See Also
-
-[IntelliSense engines](https://github.com/Microsoft/vscode-cpptools/blob/master/Documentation/LanguageServer/IntelliSense%20engine.md)
-
-[**c_cpp_properties.json** reference guide](https://github.com/Microsoft/vscode-cpptools/blob/master/Documentation/LanguageServer/c_cpp_properties.json.md)
+Please find documentation for the C/C++ extension at https://code.visualstudio.com/docs/languages/cpp.

Documentation/LanguageServer/Archive/Enabling logging.md

@@ -0,0 +1,16 @@
+#### Old information (it still works, but is no longer recommended):
+
+Logging is controlled by environment variables and is disabled by default. To enable logging, launch VS Code from an environment that contains the following variables:
+
+```
+VSCODE_CPP_LOGDIR=c:\path\to\logfolder
+VSCODE_CPP_LOGFILE_LEVEL=5
+```
+
+When you open your folder in VS Code, we will create a **vscode.cpp.log.\<pid\>.txt** file for each extension process launched (\<pid\> = process id).
+
+The log file level is a number that determines how much detail we'll log. Level 5 is generally detailed enough to give us information about what is going on in your session. We don't recommend you set this higher than 7 since the log quickly becomes cluttered with information that doesn't really help us diagnose your issues and actually makes it harder for us to spot problems. It may also slow down the extension considerably and make it harder for you to reproduce your problem.
+
+**Note:** You will likely need to reload the window or close VS Code to flush the contents of the log file since we do not flush the log after every call. If your log file seems to be empty, try reloading the window after you have followed the steps to reproduce your issue.
+
+**Don't forget to remove the environment variables when you are finished providing us with the logs.** You wouldn't want the extension to needlessly spend CPU time and disk space writing data you don't need into log files.

Documentation/LanguageServer/Archive/MinGW.md

@@ -0,0 +1,76 @@
+## Extension version 0.16.1 and earlier:
+
+For developers using MinGW on Windows, we recommend you start with the following **c_cpp_properties.json** template.  Select "C/Cpp: Edit Configurations" from the command palette to create this file if you haven't already.
+
+In earlier versions of the extension, the `includePath` and a some system defines need to be set in order for IntelliSense to work properly. Note that you may have to change the MinGW version number to match what you have installed. Eg. `C:/MinGW/lib/gcc/mingw32/5.3.0/` instead of `C:/MinGW/lib/gcc/mingw32/6.3.0/`.
+
+```json
+{
+    "configurations": [
+        {
+            "name": "MinGW",
+            "intelliSenseMode": "clang-x64",
+            "includePath": [
+                "${workspaceRoot}",
+                "C:/MinGW/lib/gcc/mingw32/6.3.0/include/c++",
+                "C:/MinGW/lib/gcc/mingw32/6.3.0/include/c++/mingw32",
+                "C:/MinGW/lib/gcc/mingw32/6.3.0/include/c++/backward",
+                "C:/MinGW/lib/gcc/mingw32/6.3.0/include",
+                "C:/MinGW/include",
+                "C:/MinGW/lib/gcc/mingw32/6.3.0/include-fixed"
+            ],
+            "defines": [
+                "_DEBUG",
+                "__GNUC__=6",
+                "__cdecl=__attribute__((__cdecl__))"
+            ],
+            "browse": {
+                "path": [
+                    "C:/MinGW/lib/gcc/mingw32/6.3.0/include",
+                    "C:/MinGW/lib/gcc/mingw32/6.3.0/include-fixed",
+                    "C:/MinGW/include/*",
+                    "${workspaceRoot}"
+                ],
+                "limitSymbolsToIncludedHeaders": true,
+                "databaseFilename": ""
+            }
+        }
+    ]
+}
+```
+
+The `includePath` above includes the system header paths that gcc uses in version 6.3.0 for C++ projects and matches the output of `"gcc -v -E -x c++ nul"`. The `intelliSenseMode` should be set to **"clang-x64"** to get MinGW projects to work properly with IntelliSense. The `__GNUC__=#` define should match the major version of the toolchain in your installation (6 in this example).
+
+For C projects, simply remove the C++ lines:
+
+```json
+{
+    "configurations": [
+        {
+            "name": "MinGW",
+            "intelliSenseMode": "clang-x64",
+            "includePath": [
+                "${workspaceRoot}",
+                "C:/MinGW/lib/gcc/mingw32/6.3.0/include",
+                "C:/MinGW/include",
+                "C:/MinGW/lib/gcc/mingw32/6.3.0/include-fixed"
+            ],
+            "defines": [
+                "_DEBUG",
+                "__GNUC__=6",
+                "__cdecl=__attribute__((__cdecl__))"
+            ],
+            "browse": {
+                "path": [
+                    "C:/MinGW/lib/gcc/mingw32/6.3.0/include",
+                    "C:/MinGW/lib/gcc/mingw32/6.3.0/include-fixed",
+                    "C:/MinGW/include/*",
+                    "${workspaceRoot}"
+                ],
+                "limitSymbolsToIncludedHeaders": true,
+                "databaseFilename": ""
+            }
+        }
+    ]
+}
+```

Documentation/LanguageServer/Archive/Windows Subsystem for Linux.md

@@ -0,0 +1,139 @@
+# Windows Subsystem for Linux
+
+To use the Windows Subsystem for Linux with this extension you need to add a configuration to your **c_cpp_properties.json** file which adds the necessary header paths from within the WSL filesystem to the `includePath`.
+
+Select "C/Cpp: Edit Configurations" from the command palette to create the **c_cpp_properties.json** file if you haven't already.
+
+## Release
+
+For developers using Ubuntu with the current version of WSL released with the Fall Creators Update, you can add the following configuration template to your **c_cpp_properties.json** file.
+
+```json
+{
+    "name": "WSL",
+    "intelliSenseMode": "clang-x64",
+    "includePath": [
+        "${workspaceRoot}",
+        "${localappdata}/Packages/CanonicalGroupLimited.UbuntuonWindows_79rhkp1fndgsc/LocalState/rootfs/usr/include/c++/5",
+        "${localappdata}/Packages/CanonicalGroupLimited.UbuntuonWindows_79rhkp1fndgsc/LocalState/rootfs/usr/include/x86_64-linux-gnu/c++/5",
+        "${localappdata}/Packages/CanonicalGroupLimited.UbuntuonWindows_79rhkp1fndgsc/LocalState/rootfs/usr/include/c++/5/backward",
+        "${localappdata}/Packages/CanonicalGroupLimited.UbuntuonWindows_79rhkp1fndgsc/LocalState/rootfs/usr/lib/gcc/x86_64-linux-gnu/5/include",
+        "${localappdata}/Packages/CanonicalGroupLimited.UbuntuonWindows_79rhkp1fndgsc/LocalState/rootfs/usr/local/include",
+        "${localappdata}/Packages/CanonicalGroupLimited.UbuntuonWindows_79rhkp1fndgsc/LocalState/rootfs/usr/lib/gcc/x86_64-linux-gnu/5/include-fixed",
+        "${localappdata}/Packages/CanonicalGroupLimited.UbuntuonWindows_79rhkp1fndgsc/LocalState/rootfs/usr/include/x86_64-linux-gnu",
+        "${localappdata}/Packages/CanonicalGroupLimited.UbuntuonWindows_79rhkp1fndgsc/LocalState/rootfs/usr/include"
+    ],
+    "defines": [
+        "__linux__",
+        "__x86_64__"
+    ],
+    "browse": {
+        "path": [
+            "${localappdata}/Packages/CanonicalGroupLimited.UbuntuonWindows_79rhkp1fndgsc/LocalState/rootfs/usr/include/c++/5",
+            "${localappdata}/Packages/CanonicalGroupLimited.UbuntuonWindows_79rhkp1fndgsc/LocalState/rootfs/usr/include/x86_64-linux-gnu/c++/5",
+            "${localappdata}/Packages/CanonicalGroupLimited.UbuntuonWindows_79rhkp1fndgsc/LocalState/rootfs/usr/lib/gcc/x86_64-linux-gnu/5/include",
+            "${localappdata}/Packages/CanonicalGroupLimited.UbuntuonWindows_79rhkp1fndgsc/LocalState/rootfs/usr/local/include",
+            "${localappdata}/Packages/CanonicalGroupLimited.UbuntuonWindows_79rhkp1fndgsc/LocalState/rootfs/usr/lib/gcc/x86_64-linux-gnu/5/include-fixed",
+            "${localappdata}/Packages/CanonicalGroupLimited.UbuntuonWindows_79rhkp1fndgsc/LocalState/rootfs/usr/include/x86_64-linux-gnu",
+            "${localappdata}/Packages/CanonicalGroupLimited.UbuntuonWindows_79rhkp1fndgsc/LocalState/rootfs/usr/include/*"
+        ],
+        "limitSymbolsToIncludedHeaders": true,
+        "databaseFilename": ""
+    }
+}
+```
+
+The `includePath` above includes the system header paths that gcc uses for C++ projects and matches the output of `gcc -v -E -x c++ - < /dev/null`. The intelliSenseMode should be set to **"clang-x64"** to get WSL projects to work properly with IntelliSense.
+
+Note that `${localappdata}/Packages/CanonicalGroupLimited.UbuntuonWindows_79rhkp1fndgsc/LocalState/rootfs/` is the path to the root of the Ubuntu filesystem. This will be different if you are using a different distro. You can discover the paths to your distro's filesystem by using this handy PowerShell command:
+
+```Powershell
+PS R:\> ($(get-appxpackage).PackageFamilyName | findstr /i 'SUSE Ubuntu') -replace '^', "$`{localappdata`}/Packages/"
+
+${localappdata}/Packages/CanonicalGroupLimited.UbuntuonWindows_79rhkp1fndgsc
+${localappdata}/Packages/46932SUSE.openSUSELeap42.2_022rs5jcyhyac
+${localappdata}/Packages/46932SUSE.SUSELinuxEnterpriseServer12SP2_022rs5jcyhyac
+```
+
+For C projects, simply remove the C++ lines:
+
+```json
+{
+    "name": "WSL",
+    "intelliSenseMode": "clang-x64",
+    "includePath": [
+        "${workspaceRoot}",
+        "${localappdata}/Packages/CanonicalGroupLimited.UbuntuonWindows_79rhkp1fndgsc/LocalState/rootfs/usr/lib/gcc/x86_64-linux-gnu/5/include",
+        "${localappdata}/Packages/CanonicalGroupLimited.UbuntuonWindows_79rhkp1fndgsc/LocalState/rootfs/usr/local/include",
+        "${localappdata}/Packages/CanonicalGroupLimited.UbuntuonWindows_79rhkp1fndgsc/LocalState/rootfs/usr/lib/gcc/x86_64-linux-gnu/5/include-fixed",
+        "${localappdata}/Packages/CanonicalGroupLimited.UbuntuonWindows_79rhkp1fndgsc/LocalState/rootfs/usr/include/x86_64-linux-gnu",
+        "${localappdata}/Packages/CanonicalGroupLimited.UbuntuonWindows_79rhkp1fndgsc/LocalState/rootfs/usr/include"
+    ],
+    "defines": [
+        "__linux__",
+        "__x86_64__"
+    ],
+    "browse": {
+        "path": [
+            "${localappdata}/Packages/CanonicalGroupLimited.UbuntuonWindows_79rhkp1fndgsc/LocalState/rootfs/usr/lib/gcc/x86_64-linux-gnu/5/include",
+            "${localappdata}/Packages/CanonicalGroupLimited.UbuntuonWindows_79rhkp1fndgsc/LocalState/rootfs/usr/local/include",
+            "${localappdata}/Packages/CanonicalGroupLimited.UbuntuonWindows_79rhkp1fndgsc/LocalState/rootfs/usr/lib/gcc/x86_64-linux-gnu/5/include-fixed",
+            "${localappdata}/Packages/CanonicalGroupLimited.UbuntuonWindows_79rhkp1fndgsc/LocalState/rootfs/usr/include/x86_64-linux-gnu",
+            "${localappdata}/Packages/CanonicalGroupLimited.UbuntuonWindows_79rhkp1fndgsc/LocalState/rootfs/usr/include/*"
+        ],
+        "limitSymbolsToIncludedHeaders": true,
+        "databaseFilename": ""
+    }
+}
+```
+
+### Beta
+
+For developers using Bash on Ubuntu on Windows with the beta version of WSL from before the Fall Creators Update, you can add the following configuration template to your **c_cpp_properties.json** file.
+
+```json
+{
+    "name": "WSL (Beta)",
+    "intelliSenseMode": "clang-x64",
+    "includePath": [
+        "${workspaceRoot}",
+        "${localappdata}/lxss/rootfs/usr/include/c++/5",
+        "${localappdata}/lxss/rootfs/usr/include/x86_64-linux-gnu/c++/5",
+        "${localappdata}/lxss/rootfs/usr/include/c++/5/backward",
+        "${localappdata}/lxss/rootfs/usr/lib/gcc/x86_64-linux-gnu/5/include",
+        "${localappdata}/lxss/rootfs/usr/local/include",
+        "${localappdata}/lxss/rootfs/usr/lib/gcc/x86_64-linux-gnu/5/include-fixed",
+        "${localappdata}/lxss/rootfs/usr/include/x86_64-linux-gnu",
+        "${localappdata}/lxss/rootfs/usr/include"
+    ],
+    "defines": [
+        "__linux__",
+        "__x86_64__"
+    ],
+    "browse": {
+        "path": [
+            "${localappdata}/lxss/rootfs/usr/include/c++/5",
+            "${localappdata}/lxss/rootfs/usr/include/x86_64-linux-gnu/c++/5",
+            "${localappdata}/lxss/rootfs/usr/lib/gcc/x86_64-linux-gnu/5/include",
+            "${localappdata}/lxss/rootfs/usr/local/include",
+            "${localappdata}/lxss/rootfs/usr/lib/gcc/x86_64-linux-gnu/5/include-fixed",
+            "${localappdata}/lxss/rootfs/usr/include/x86_64-linux-gnu",
+            "${localappdata}/lxss/rootfs/usr/include/*"
+        ],
+        "limitSymbolsToIncludedHeaders": true,
+        "databaseFilename": ""
+    }
+}
+```
+
+The `includePath` above includes the system header paths that gcc uses for C++ projects and matches the output of `gcc -v -E -x c++ - < /dev/null`. The intelliSenseMode should be set to **"clang-x64"** to get WSL projects to work properly with IntelliSense.
+
+Note that `${localappdata}/lxss/rootfs/` is the path to the root of the filesystem for Bash on Ubuntu on Windows.
+
+For C projects, simply remove the C++ lines as in the previous example.
+
+---
+
+With these configurations, you should be all set up to use the new IntelliSense engine for linting, memberlist autocomplete, and quick info (tooltips).  Add `"C_Cpp.intelliSenseEngine": "Default"` to your **settings.json** file to try out the new IntelliSense engine.
+
+And remember to [heed the warnings of the Windows team about not creating or editing Linux files from a Windows app](https://blogs.msdn.microsoft.com/commandline/2016/11/17/do-not-change-linux-files-using-windows-apps-and-tools/)!

Documentation/LanguageServer/Customizing Default Settings.md

@@ -0,0 +1 @@
+The documentation for customizing default settings has moved to https://code.visualstudio.com/docs/cpp/customize-default-settings-cpp.

Documentation/LanguageServer/Enabling logging.md

@@ -1,24 +1 @@
-# How to enable logging in the extension
-
-If you are experiencing a problem that we are unable to diagnose based on information in your issue report, we might ask you to enable logging and send us your logs.
-
-As of version 0.14.0 of the extension, logging information is now delivered directly to the Output window in VSCode. To turn on full logging for an issue report, add `"C_Cpp.loggingLevel": "Information"` to your **settings.json**.
-
-![image](https://user-images.githubusercontent.com/12818240/31898313-b32ff284-b7cd-11e7-97f5-89df93b5d9de.png)
-
-#### Old information (it still works, but is no longer recommended):
-
-<del>
-Logging is controlled by environment variables and is disabled by default. To enable logging, launch VS Code from an environment that contains the following variables:
-
-```
-VSCODE_CPP_LOGDIR=c:\path\to\logfolder
-VSCODE_CPP_LOGFILE_LEVEL=5
-```
-
-When you open your folder in VS Code, we will create a **vscode.cpp.log.\<pid\>.txt** file for each extension process launched (\<pid\> = process id).
-
-The log file level is a number that determines how much detail we'll log. Level 5 is generally detailed enough to give us information about what is going on in your session. We don't recommend you set this higher than 7 since the log quickly becomes cluttered with information that doesn't really help us diagnose your issues and actually makes it harder for us to spot problems. It may also slow down the extension considerably and make it harder for you to reproduce your problem.
-
-**Don't forget to remove the environment variables when you are finished providing us with the logs.** You wouldn't want the extension to needlessly spend CPU time and disk space writing data you don't need into log files.
-</del>
+The documentation for logging has moved to https://code.visualstudio.com/docs/cpp/enable-logging-cpp.

Documentation/LanguageServer/FAQ.md

@@ -1,54 +1 @@
-# Frequently asked questions
-
-* [How do I get IntelliSense to work correctly?](#how-do-i-get-intellisense-to-work-correctly)
-* [Why do I see red squiggles under Standard Library types?](#why-do-i-see-red-squiggles-under-standard-library-types)
-* [How do I get the new IntelliSense to work with MinGW on Windows?](#how-do-i-get-the-new-intellisense-to-work-with-mingw-on-windows)
-* [What is the difference between `"includePath"` and `"browse.path"` in **c_cpp_properties.json**?](#what-is-the-difference-between-includepath-and-browsepath-in-c_cpp_propertiesjson)
-* [How do I re-create the IntelliSense database?](#how-do-i-re-create-the-intellisense-database)
-
-## How do I get IntelliSense to work correctly?
-
-There are two IntelliSense engines present in the extension: the "fuzzy" engine (or Tag Parser), and the new "Default" engine. If you are using version 0.11.0 or higher of the cpptools extension, then you can preview our new IntelliSense engine which has more accurate auto-complete suggestions and tooltips. To use the new engine, you need to ensure that `"C_Cpp.intelliSenseEngine"` is set to `"Default"` in your settings. Since the engine is still in preview it is not on by default for everyone yet.
-
-After selecting the IntelliSense engine that you prefer, take a look at the Problems window in VS Code to see if you need to do any further configuration for your folder. For example, the Default engine will not provide squiggles and auto-complete suggestions for a translation unit (read: a source file and its dependencies) if the include path is not configured properly. You can select any of the problems in the window to navigate to the line when the problem was detected and a lightbulb will appear in the editor with some options (code actions) to help you resolve the problem:
-
-1. Update your `includePath` (and preprocessor defines)
-2. Force semantic IntelliSense
-
-#### Update your `includePath` (and preprocessor defines)
-
-Selecting this option will open a file called **c_cpp_properties.json**. If you haven't created this file already, it will be created for you in the **.vscode** folder of your workspace.
-
-Add the necessary paths to your include files to the `"includePath"` array. The `${workspaceRoot}` variable is available to use to get a relative path to the folder you have opened. Also add any required symbols that need to be defined to the `"defines"` array. Both "\<var\>" and "\<var\>=\<value\>" syntax is accepted. When you edit and save this file, the IntelliSense engine will reset and reparse source your source files and headers with the new settings.
-
-#### Force semantic IntelliSense
-
-If you want IntelliSense to operate on your files even when all #include directives do not resolve, then you can choose the `Force semantic IntelliSense` code action to always use the new IntelliSense engine. You can also set the `C_Cpp.intelliSenseEngineFallback` setting to `"Disabled"`.
-
-## Why do I see red squiggles under Standard Library types?
-
-The most common reason for this is missing or sorted include paths. If you are using a compiler in the GCC family, the system includes that you add to your `"includePath"` in **c_cpp_properties.json** should match the output of the following command: `gcc -Wp,-v -E -xc -x c++ /dev/null` (replace 'gcc' with whichever compiler you are using). GCC and its relatives require the paths to be in a specific order too, so sorting the paths for aesthetics will likely result in incorrect IntelliSense results.
-
-## How do I get the new IntelliSense to work with MinGW on Windows?
-
-Since MinGW is a relative of GCC, Microsoft mode compilation (which is the default on Windows) doesn't work very well with it. To use GCC/CLang mode, set the `"intelliSenseMode"` property in your **c_cpp_properties.json** file to `"clang-x64"`. An example **c_cpp_properties.json** [is shared here for your convenience](https://github.com/Microsoft/vscode-cpptools/blob/master/Documentation/LanguageServer/MinGW.md).
-
-## What is the difference between `"includePath"` and `"browse.path"` in **c_cpp_properties.json**?
-
-Starting with version 0.11.0 of the cpptools extension, there are now two settings in the **c_cpp_properties.json** file. They are used by the different IntelliSense engines that we support and have slightly different meanings for the components that use them.
-
-The active IntelliSense engine is controlled via the `"C_Cpp.intelliSenseEngine"` setting in your **settings.json** file. The valid values for this setting are `"Default"` and `"Tag Parser"`.
-
-* #### `"includePath"`
-  This array of path strings is used by the new "Default" IntelliSense engine that was introduced in version 0.11.0 of the extension. This new engine provides semantic-aware IntelliSense features and will be the eventual replacement for the Tag Parser that has been powering the extension since it was first released. It currently provides tooltips and error squiggles in the editor. The remaining features (e.g. code completion, signature help, go to definition, ...) are implemented using the Tag Parser's database, so it is still important to ensure that the browse.path setting is properly set.
-
-  The paths that you specify for this setting are the same paths that you would send to your compiler via the `-I` switch. When your source files are parsed, the IntelliSense engine will prepend these paths to the files specified by your #include directives while attempting to resolve them. These paths are **not** searched recursively.
-
-* #### `"browse.path"`
-  This array of path strings is used by the "Tag Parser" (a.k.a. "browse engine"). This engine will _recursively_ enumerate all files under the paths specified and track them as potential includes while tag parsing your project folder. To disable recursive enumeration of a path, you can append a `/*` to the path string.
-
-When you open a workspace for the first time, the extension adds `${workspaceRoot}` to both arrays. If this is undesirable, you can open your **c_cpp_properties.json** file and remove it.
-
-## How do I re-create the IntelliSense database?
-
-Starting in version 0.12.3 of the extension, we added a command that will reset your IntelliSense database. Open the command palette and choose the "C/Cpp: Reset IntelliSense Database" command.
+The FAQs for the C/C++ extension has moved to https://code.visualstudio.com/docs/cpp/faq-cpp.

Documentation/LanguageServer/IntelliSense engine.md

@@ -1,44 +0,0 @@
-# IntelliSense engines
-
-There are two IntelliSense engines used to power the C/C++ IntelliSense experience in VS Code.
-
-* `"Default"` - Visual Studio's IntelliSense engine, which is the default engine that provides semantic-aware IntelliSense features
-* `"Tag Parser"` - the "fuzzy" IntelliSense engine that provides quick but "fuzzy" results, is used to provide the fallback experience if the default engine is unable to fully resolve include paths
-
-Ultimately all the IntelliSense and code browsing features will be powered by the "Default" engine. The following features have been implemented so far:
-
-* Auto-complete suggestions for class/struct/namespace members
-* Parameter hints
-* Quick info (hover over tooltip)
-* Error squiggles
-* Reference highlighting
-
-The other IntelliSense features, such as global auto-complete, and code browsing features, such as Go to definition/declaration, are currently powered by the "Tag Parser" based engine.
-
-### `includePath` and `browse.path`
-The two IntelliSense engines use two different settings in the **c_cpp_properties.json** file for specifying include paths. This file is located in the **.vscode** directory in the opened folder. You can create or open this file by either using the "C/Cpp: Edit Configurations" command in the command palette or by selecting "Edit "includePath" setting" in the lightbulb menu. Look for the following settings in the section where your current configuration is defined (by default there's one configuration per OS, such as "Win32 or "Mac").
-
-* #### `"includePath"`
-  This array of path strings is used by the "Default" IntelliSense engine. The paths that you specify for this setting are the same paths that you would send to your compiler via the -I switch. When your source files are parsed, the IntelliSense engine will prepend these paths to the files specified by your #include directives while attempting to resolve them. These paths are searched **non-recursively**.
-
-* #### `"browse.path"`
-  This array of path strings is used by the "Tag Parser" (a.k.a. "browse engine"). This engine will **recursively** enumerate all files under the paths specified and track them as potential includes while tag parsing your project folder. To disable recursive enumeration of a path, you can append a `/*` to the path string.
-
-### How fallback works and how to control the behavior
-
-The extension first tries to fully parse any opened file using the "Default" IntelliSense engine. If it discovers that it cannot find a header file or a dependency, it will fall back to the tag parser and provide the fuzzy IntelliSense behavior. The fallback affects a full translation unit (TU), not just a single open file. The Problems panel provides details about unresolved headers and dependencies. Other opened TUs will continue to use the "Default" IntelliSense engine provided that all #include dependencies are resolved.
-
-We recognize that resolving all #includes may not be necessary for all projects and you may still want to experience the productivity benefits of using the "Default" semantic engine without customizing the default include path. For that, the “Force semantic IntelliSense” action can be chosen. When invoked, all unresolved #include squiggles will turn red and semantic member list and linting will be enabled in all files regardless of whether or not #include statements can be resolved.
-
-### IntelliSense engine setting
-
-We recommend using the "Default" engine for the best IntelliSense experience. However, it is possible to explicitly choose the IntelliSense engine by editing your [user or workspace settings](https://code.visualstudio.com/docs/getstarted/settings). The setting you should modify is `"C_Cpp.intelliSenseEngine"`. There are two values for this setting:
-
-* `"Default"` - use Visual Studio's IntelliSense engine
-* `"Tag Parser"` - use the "fuzzy" IntelliSense engine
-
-### See Also
-
-[Configuring includePath for better IntelliSense results](https://github.com/Microsoft/vscode-cpptools/blob/master/Documentation/Getting%20started.md)
-
-[**c_cpp_properties.json** reference guide](https://github.com/Microsoft/vscode-cpptools/blob/master/Documentation/LanguageServer/c_cpp_properties.json.md)

Documentation/LanguageServer/MinGW.md

@@ -1,76 +1,2 @@
-For developers using MinGW on Windows, we recommend you start with the following **c_cpp_properties.json** template.  Select "C/Cpp: Edit Configurations" from the command palette to create this file if you haven't already.
 
-Note that you may have to change the MinGW version number to match what you have installed. Eg. `C:/MinGW/lib/gcc/mingw32/5.3.0/` instead of `C:/MinGW/lib/gcc/mingw32/6.3.0/`.
-
-```json
-{
-    "configurations": [
-        {
-            "name": "Win32",
-            "intelliSenseMode": "clang-x64",
-            "includePath": [
-                "${workspaceRoot}",
-                "C:/MinGW/lib/gcc/mingw32/6.3.0/include/c++",
-                "C:/MinGW/lib/gcc/mingw32/6.3.0/include/c++/mingw32",
-                "C:/MinGW/lib/gcc/mingw32/6.3.0/include/c++/backward",
-                "C:/MinGW/lib/gcc/mingw32/6.3.0/include",
-                "C:/MinGW/include",
-                "C:/MinGW/lib/gcc/mingw32/6.3.0/include-fixed"
-            ],
-            "defines": [
-                "_DEBUG",
-                "UNICODE",
-                "__GNUC__=6",
-                "__cdecl=__attribute__((__cdecl__))"
-            ],
-            "browse": {
-                "path": [
-                    "C:/MinGW/lib/gcc/mingw32/6.3.0/include",
-                    "C:/MinGW/lib/gcc/mingw32/6.3.0/include-fixed",
-                    "C:/MinGW/include/*"
-                ],
-                "limitSymbolsToIncludedHeaders": true,
-                "databaseFilename": ""
-            }
-        }
-    ]
-}
-```
-
-The `includePath` above includes the system header paths that gcc uses in version 6.3.0 for C++ projects and matches the output of `gcc -v -E -x c++ -`. The `intelliSenseMode` should be set to **"clang-x64"** to get MinGW projects to work properly with IntelliSense. The `__GNUC__=#` define should match the major version of the toolchain in your installation (6 in this example).
-
-For C projects, simply remove the C++ lines:
-
-```json
-{
-    "configurations": [
-        {
-            "name": "Win32",
-            "intelliSenseMode": "clang-x64",
-            "includePath": [
-                "${workspaceRoot}",
-                "C:/MinGW/lib/gcc/mingw32/6.3.0/include",
-                "C:/MinGW/include",
-                "C:/MinGW/lib/gcc/mingw32/6.3.0/include-fixed"
-            ],
-            "defines": [
-                "_DEBUG",
-                "UNICODE",
-                "__GNUC__=6",
-                "__cdecl=__attribute__((__cdecl__))"
-            ],
-            "browse": {
-                "path": [
-                    "C:/MinGW/lib/gcc/mingw32/6.3.0/include",
-                    "C:/MinGW/lib/gcc/mingw32/6.3.0/include-fixed",
-                    "C:/MinGW/include/*"
-                ],
-                "limitSymbolsToIncludedHeaders": true,
-                "databaseFilename": ""
-            }
-        }
-    ]
-}
-```
-
-With these configurations, you should be all set up to use the new IntelliSense engine for linting, memberlist autocomplete, and quick info (tooltips).  Add `"C_Cpp.intelliSenseEngine": "Default"` to your **settings.json** file to try out the new IntelliSense engine.
+The documentation for Mingw-w64 has moved to https://code.visualstudio.com/docs/cpp/config-mingw.

Documentation/LanguageServer/Windows Subsystem for Linux.md

@@ -1,139 +1 @@
-# Windows Subsystem for Linux
-
-To use the Windows Subsystem for Linux with this extension you need to add a configuration to your **c_cpp_properties.json** file which adds the necessary header paths from within the WSL filesystem to the `includePath`.
-
-Select "C/Cpp: Edit Configurations" from the command palette to create the **c_cpp_properties.json** file if you haven't already.
-
-## Release
-
-For developers using Ubuntu with the current version of WSL released with the Fall Creators Update, you can add the following configuration template to your **c_cpp_properties.json** file.
-
-```json
-{
-    "name": "WSL",
-    "intelliSenseMode": "clang-x64",
-    "includePath": [
-        "${workspaceRoot}",
-        "${localappdata}/Packages/CanonicalGroupLimited.UbuntuonWindows_79rhkp1fndgsc/LocalState/rootfs/usr/include/c++/5",
-        "${localappdata}/Packages/CanonicalGroupLimited.UbuntuonWindows_79rhkp1fndgsc/LocalState/rootfs/usr/include/x86_64-linux-gnu/c++/5",
-        "${localappdata}/Packages/CanonicalGroupLimited.UbuntuonWindows_79rhkp1fndgsc/LocalState/rootfs/usr/include/c++/5/backward",
-        "${localappdata}/Packages/CanonicalGroupLimited.UbuntuonWindows_79rhkp1fndgsc/LocalState/rootfs/usr/lib/gcc/x86_64-linux-gnu/5/include",
-        "${localappdata}/Packages/CanonicalGroupLimited.UbuntuonWindows_79rhkp1fndgsc/LocalState/rootfs/usr/local/include",
-        "${localappdata}/Packages/CanonicalGroupLimited.UbuntuonWindows_79rhkp1fndgsc/LocalState/rootfs/usr/lib/gcc/x86_64-linux-gnu/5/include-fixed",
-        "${localappdata}/Packages/CanonicalGroupLimited.UbuntuonWindows_79rhkp1fndgsc/LocalState/rootfs/usr/include/x86_64-linux-gnu",
-        "${localappdata}/Packages/CanonicalGroupLimited.UbuntuonWindows_79rhkp1fndgsc/LocalState/rootfs/usr/include"
-    ],
-    "defines": [
-        "__linux__",
-        "__x86_64__"
-    ],
-    "browse": {
-        "path": [
-            "${localappdata}/Packages/CanonicalGroupLimited.UbuntuonWindows_79rhkp1fndgsc/LocalState/rootfs/usr/include/c++/5",
-            "${localappdata}/Packages/CanonicalGroupLimited.UbuntuonWindows_79rhkp1fndgsc/LocalState/rootfs/usr/include/x86_64-linux-gnu/c++/5",
-            "${localappdata}/Packages/CanonicalGroupLimited.UbuntuonWindows_79rhkp1fndgsc/LocalState/rootfs/usr/lib/gcc/x86_64-linux-gnu/5/include",
-            "${localappdata}/Packages/CanonicalGroupLimited.UbuntuonWindows_79rhkp1fndgsc/LocalState/rootfs/usr/local/include",
-            "${localappdata}/Packages/CanonicalGroupLimited.UbuntuonWindows_79rhkp1fndgsc/LocalState/rootfs/usr/lib/gcc/x86_64-linux-gnu/5/include-fixed",
-            "${localappdata}/Packages/CanonicalGroupLimited.UbuntuonWindows_79rhkp1fndgsc/LocalState/rootfs/usr/include/x86_64-linux-gnu",
-            "${localappdata}/Packages/CanonicalGroupLimited.UbuntuonWindows_79rhkp1fndgsc/LocalState/rootfs/usr/include/*"
-        ],
-        "limitSymbolsToIncludedHeaders": true,
-        "databaseFilename": ""
-    }
-}
-```
-
-The `includePath` above includes the system header paths that gcc uses for C++ projects and matches the output of `gcc -v -E -x c++ - < /dev/null`. The intelliSenseMode should be set to **"clang-x64"** to get WSL projects to work properly with IntelliSense.
-
-Note that `${localappdata}/Packages/CanonicalGroupLimited.UbuntuonWindows_79rhkp1fndgsc/LocalState/rootfs/` is the path to the root of the Ubuntu filesystem. This will be different if you are using a different distro. You can discover the paths to your distro's filesystem by using this handy PowerShell command:
-
-```Powershell
-PS R:\> ($(get-appxpackage).PackageFamilyName | findstr /i 'SUSE Ubuntu') -replace '^', "$`{localappdata`}/Packages/"
-
-${localappdata}/Packages/CanonicalGroupLimited.UbuntuonWindows_79rhkp1fndgsc
-${localappdata}/Packages/46932SUSE.openSUSELeap42.2_022rs5jcyhyac
-${localappdata}/Packages/46932SUSE.SUSELinuxEnterpriseServer12SP2_022rs5jcyhyac
-```
-
-For C projects, simply remove the C++ lines:
-
-```json
-{
-    "name": "WSL",
-    "intelliSenseMode": "clang-x64",
-    "includePath": [
-        "${workspaceRoot}",
-        "${localappdata}/Packages/CanonicalGroupLimited.UbuntuonWindows_79rhkp1fndgsc/LocalState/rootfs/usr/lib/gcc/x86_64-linux-gnu/5/include",
-        "${localappdata}/Packages/CanonicalGroupLimited.UbuntuonWindows_79rhkp1fndgsc/LocalState/rootfs/usr/local/include",
-        "${localappdata}/Packages/CanonicalGroupLimited.UbuntuonWindows_79rhkp1fndgsc/LocalState/rootfs/usr/lib/gcc/x86_64-linux-gnu/5/include-fixed",
-        "${localappdata}/Packages/CanonicalGroupLimited.UbuntuonWindows_79rhkp1fndgsc/LocalState/rootfs/usr/include/x86_64-linux-gnu",
-        "${localappdata}/Packages/CanonicalGroupLimited.UbuntuonWindows_79rhkp1fndgsc/LocalState/rootfs/usr/include"
-    ],
-    "defines": [
-        "__linux__",
-        "__x86_64__"
-    ],
-    "browse": {
-        "path": [
-            "${localappdata}/Packages/CanonicalGroupLimited.UbuntuonWindows_79rhkp1fndgsc/LocalState/rootfs/usr/lib/gcc/x86_64-linux-gnu/5/include",
-            "${localappdata}/Packages/CanonicalGroupLimited.UbuntuonWindows_79rhkp1fndgsc/LocalState/rootfs/usr/local/include",
-            "${localappdata}/Packages/CanonicalGroupLimited.UbuntuonWindows_79rhkp1fndgsc/LocalState/rootfs/usr/lib/gcc/x86_64-linux-gnu/5/include-fixed",
-            "${localappdata}/Packages/CanonicalGroupLimited.UbuntuonWindows_79rhkp1fndgsc/LocalState/rootfs/usr/include/x86_64-linux-gnu",
-            "${localappdata}/Packages/CanonicalGroupLimited.UbuntuonWindows_79rhkp1fndgsc/LocalState/rootfs/usr/include/*"
-        ],
-        "limitSymbolsToIncludedHeaders": true,
-        "databaseFilename": ""
-    }
-}
-```
-
-## Beta
-
-For developers using Bash on Ubuntu on Windows with the beta version of WSL from before the Fall Creators Update, you can add the following configuration template to your **c_cpp_properties.json** file.
-
-```json
-{
-    "name": "WSL (Beta)",
-    "intelliSenseMode": "clang-x64",
-    "includePath": [
-        "${workspaceRoot}",
-        "${localappdata}/lxss/rootfs/usr/include/c++/5",
-        "${localappdata}/lxss/rootfs/usr/include/x86_64-linux-gnu/c++/5",
-        "${localappdata}/lxss/rootfs/usr/include/c++/5/backward",
-        "${localappdata}/lxss/rootfs/usr/lib/gcc/x86_64-linux-gnu/5/include",
-        "${localappdata}/lxss/rootfs/usr/local/include",
-        "${localappdata}/lxss/rootfs/usr/lib/gcc/x86_64-linux-gnu/5/include-fixed",
-        "${localappdata}/lxss/rootfs/usr/include/x86_64-linux-gnu",
-        "${localappdata}/lxss/rootfs/usr/include"
-    ],
-    "defines": [
-        "__linux__",
-        "__x86_64__"
-    ],
-    "browse": {
-        "path": [
-            "${localappdata}/lxss/rootfs/usr/include/c++/5",
-            "${localappdata}/lxss/rootfs/usr/include/x86_64-linux-gnu/c++/5",
-            "${localappdata}/lxss/rootfs/usr/lib/gcc/x86_64-linux-gnu/5/include",
-            "${localappdata}/lxss/rootfs/usr/local/include",
-            "${localappdata}/lxss/rootfs/usr/lib/gcc/x86_64-linux-gnu/5/include-fixed",
-            "${localappdata}/lxss/rootfs/usr/include/x86_64-linux-gnu",
-            "${localappdata}/lxss/rootfs/usr/include/*"
-        ],
-        "limitSymbolsToIncludedHeaders": true,
-        "databaseFilename": ""
-    }
-}
-```
-
-The `includePath` above includes the system header paths that gcc uses for C++ projects and matches the output of `gcc -v -E -x c++ - < /dev/null`. The intelliSenseMode should be set to **"clang-x64"** to get WSL projects to work properly with IntelliSense.
-
-Note that `${localappdata}/lxss/rootfs/` is the path to the root of the filesystem for Bash on Ubuntu on Windows.
-
-For C projects, simply remove the C++ lines as in the previous example.
-
----
-
-With these configurations, you should be all set up to use the new IntelliSense engine for linting, memberlist autocomplete, and quick info (tooltips).  Add `"C_Cpp.intelliSenseEngine": "Default"` to your **settings.json** file to try out the new IntelliSense engine.
-
-And remember to [heed the warnings of the Windows team about not creating or editing Linux files from a Windows app](https://blogs.msdn.microsoft.com/commandline/2016/11/17/do-not-change-linux-files-using-windows-apps-and-tools/)!
+The documentation for GCC on Windows Subsystem for Linux (WSL) has moved to https://code.visualstudio.com/docs/cpp/config-wsl.

Documentation/LanguageServer/c_cpp_properties.json.md

@@ -1,84 +1 @@
-# `c_cpp_properties.json` Reference Guide
-
-### Example
-
-```json
-{
-    "configurations": [
-        {
-            "name": "Win32",
-            "intelliSenseMode": "msvc-x64",
-            "includePath": [ "${workspaceFolder}" ],
-            "macFrameworkPath": [ "/System/Library/Frameworks" ],
-            "defines": [ "FOO", "BAR=100" ],
-            "forcedInclude": [ "${workspaceFolder}/include/config.h" ],
-            "compilerPath": "/usr/bin/clang",
-            "cStandard": "c11",
-            "cppStandard": "c++17",
-            "compileCommands": "/path/to/compile_commands.json",
-            "browse": {
-                "path": [ "${workspaceFolder}" ],
-                "limitSymbolsToIncludedHeaders": true,
-                "databaseFilename": ""
-            }
-        }
-    ],
-    "version": 3
-}
-```
-
-## Top-level properties
-
-* #### `configurations`
-  An array of configuration objects that provide the IntelliSense engine with information about your project and your preferences. By default, the extension creates 3 configurations for you, one each for Linux, Mac, and Windows, but it is not required to keep them all. You may also add additional configurations if necessary.
-
-* #### `version`
-  We recommend you don't edit this field. It tracks the current version of the **c_cpp_properties.json** file so that the extension knows what properties and settings should be present and how to upgrade this file to the latest version.
-
-## Configuration properties
-
-* #### `name`
-  A friendly name for the configuration. "Linux", "Mac", and "Win32" are special names that instruct the extension to load that configuration by default on the associated operating system unless additional configurations have been created. The status bar in VS Code will show you which configuration is active. You can also click on the label in the status bar to change the active configuration.
-
-* #### `intelliSenseMode`
-  If `"C_Cpp.intelliSenseEngine"` is set to "Default" in your settings file, this property determines which mode the IntelliSense engine will run in. `"msvc-x64"` maps to Visual Studio mode with 64-bit pointer sizes. `"clang-x64"` maps to GCC/CLang mode with 64-bit pointer sizes. Windows uses `"msvc-x64"` by default and Linux/Mac use `"clang-x64"` by default.
-
-* #### `includePath`
-  If `"C_Cpp.intelliSenseEngine"` is set to "Default" in your settings file, this list of paths will be used by IntelliSense to search for headers included by your source files. This is basically the same as the list of paths you pass to your compiler with the `-I` switch; the IntelliSense engine will not do a recursive search in these paths for includes. If a GCC/CLang compiler is specified in the `compilerPath` setting, it is not necessary to list the system include paths in this list.
-
-* #### `macFrameworkPath`
-  If `"C_Cpp.intelliSenseEngine"` is set to "Default" in your settings file, this list of paths will be used by IntelliSense to search for framework headers included by your source files. This is basically the same as the list of paths you pass to your compiler with the `-F` switch; the IntelliSense engine will not do a recursive search in these paths for includes.
-
-* #### `defines`
-  If `"C_Cpp.intelliSenseEngine"` is set to "Default" in your settings file, this list of preprocessor symbols will be used by IntelliSense during the compilation of your source files. This is basically the same as the list of symbols you pass to your compiler with the `-D` switch.
-
-* #### `forcedInclude` (optional)
-  A list of files that should be included before any other characters in the source file are processed. Files are included in the order listed.
-
-* #### `compilerPath` (optional)
-  The absolute path to the compiler you use to build your project. The extension will query the compiler to determine the system include paths and default defines to use for IntelliSense. Args can be added to modify the includes/defines used, e.g. `-nostdinc++`, `-m32`, etc., but paths with spaces must be surrounded by double quotes (`"`) if args are used.
-
-* #### `cStandard`
-  The C standard revision to use for IntelliSense in your project.
-
-* #### `cppStandard`
-  The C++ standard revision to use for IntelliSense in your project.
-
-* #### `compileCommands` (optional)
-  If `"C_Cpp.intelliSenseEngine"` is set to "Default" in your settings file, the includes and defines discovered in this file will be used instead of the values set for `includePath` and `defines`. If the compile commands database does not contain an entry for the translation unit that corresponds to the file you opened in the editor, then a warning message will appear and the extension will use the `includePath` and `defines` settings instead.
-
-  *For more information about the file format, see the [Clang documentation](https://clang.llvm.org/docs/JSONCompilationDatabase.html). Some build systems, such as CMake, [simplify generating this file](https://cmake.org/cmake/help/v3.5/variable/CMAKE_EXPORT_COMPILE_COMMANDS.html).*
-
-* #### `browse`
-  The set of properties used when `"C_Cpp.intelliSenseEngine"` is set to `"Tag Parser"` (also referred to as "fuzzy" IntelliSense, or the "browse" engine). These properties are also used by the Go To Definition/Declaration features, or when the "Default" IntelliSense engine is unable to resolve the #includes in your source files.
-
-### Browse properties
-
-* #### `path`
-  This list of paths will be used by the Tag Parser to search for headers included by your source files. The Tag Parser will automatically search all subfolders in these paths unless the path ends with a `/*` or `\*`. For example, `/usr/include` directs the Tag Parser to search the `include` folder and its subfolders for headers while `/usr/include/*` directs the Tag Parser not to look in any subfolders of `/usr/include`.
-
-* #### `limitSymbolsToIncludedHeaders`
-  When true, the Tag Parser will only parse code files that have been directly or indirectly included by a source file in `${workspaceRoot}`. When false, the Tag Parser will parse all code files found in the paths specified in the **path** list.
-
-* #### `databaseFilename`
-  When set, this instructs the extension to save the Tag Parser's symbol database somewhere other than the workspace's default storage location. If a relative path is specified, it will be made relative to the workspace's default storage location, not the workspace folder itself. The `${workspaceRoot}` variable can be used to specify a path relative to the workspace folder (e.g. `$[workspaceRoot}/.vscode/browse.vc.db`)
+The documentation for c_cpp_properties.json has moved to https://code.visualstudio.com/docs/cpp/c-cpp-properties-schema-reference.

Documentation/LanguageServer/colorization.md

@@ -0,0 +1 @@
+The documentation for enhanced colorization has moved to https://code.visualstudio.com/docs/cpp/colorization-cpp.

Extension/.eslintignore

@@ -0,0 +1,4 @@
+*.js
+test/**/index.ts
+test/**/runTest.ts
+tools/prepublish.js