├── .azure-pipelines
└── azure-pipelines.yml
├── .gitignore
├── LICENSE
├── SECURITY.md
├── azure-devops-extension.json
├── configs
├── dev.json
├── release.json
└── test.json
├── css
└── wsjfSettings.css
├── images
├── icon-refresh.png
└── logo.png
├── marketplace
├── AutoCalcWSJF.gif
├── RecalculateWSJF.png
├── WSJF-Setting.png
├── WSJF-create-fields.png
├── WSJF-used-values.png
├── WSJF_on_form.png
└── details.md
├── package-lock.json
├── package.json
├── readme.md
├── src
├── wsjf.tsx
├── wsjfModels.tsx
└── wsjfSettings.tsx
├── tsconfig.json
├── wsjf.html
└── wsjfSettings.html
/.azure-pipelines/azure-pipelines.yml:
--------------------------------------------------------------------------------
1 | variables:
2 | - name: version.MajorMinor # Manually adjust the version number as needed for semantic versioning. Patch is auto-incremented.
3 | value: '1.2'
4 | - name: extensionName
5 | value: 'WSJF-extension'
6 | - name: marketplaceServiceConnection
7 | value: 'marketplaceServiceConnection'
8 | - name: publisherId
9 | value: 'MS-Agile-SAFe'
10 | - name: publicExtensionName
11 | value: "WSJF (Weighted Shortest Job First)"
12 |
13 | name: $(version.MajorMinor)$(rev:.r)
14 |
15 | trigger:
16 | branches:
17 | include:
18 | - master
19 |
20 | pr: none
21 |
22 | resources:
23 | repositories:
24 | - repository: pipeline-templates
25 | type: git
26 | name: DevLabs Extensions/pipeline-templates
27 | ref: main
28 |
29 | stages:
30 | - stage: 'Build'
31 | jobs:
32 | - job: 'BuildPack'
33 | displayName: "Build and package"
34 | pool:
35 | vmImage: ubuntu-latest
36 | steps:
37 | - task: NodeTool@0
38 | inputs:
39 | versionSpec: '14.x'
40 | - template: build.yml@pipeline-templates
41 | - template: package.yml@pipeline-templates
42 | parameters:
43 | extensionName: $(extensionName)
44 | outputPath: 'out'
45 | rootPath: './'
46 |
47 | - stage: 'DeployDev'
48 | displayName: 'Deploy to dev'
49 | dependsOn: Build
50 | condition: succeeded()
51 | jobs:
52 | - template: deploy.yml@pipeline-templates
53 | parameters:
54 | environment: 'dev'
55 | extensionName: $(extensionName)
56 | marketplaceConnectedServiceName: $(marketplaceServiceConnection)
57 | publisherId: $(publisherId)
58 | publicExtensionName: $(publicExtensionName)
59 | updateTaskVersion: true
60 |
61 | - stage: 'DeployTest'
62 | displayName: 'Deploy to Test'
63 | dependsOn: DeployDev
64 | condition: succeeded()
65 | jobs:
66 | - template: deploy.yml@pipeline-templates
67 | parameters:
68 | environment: 'test'
69 | extensionName: $(extensionName)
70 | marketplaceConnectedServiceName: $(marketplaceServiceConnection)
71 | publisherId: $(publisherId)
72 | publicExtensionName: $(publicExtensionName)
73 | updateTaskVersion: true
74 |
75 | - stage: 'DeployRelease'
76 | displayName: 'Deploy Release'
77 | dependsOn: DeployTest
78 | condition: succeeded()
79 | jobs:
80 | - template: deploy.yml@pipeline-templates
81 | parameters:
82 | environment: 'public'
83 | extensionName: $(extensionName)
84 | marketplaceConnectedServiceName: $(marketplaceServiceConnection)
85 | publisherId: $(publisherId)
86 | publicExtensionName: $(publicExtensionName)
87 | extensionVisibility: 'public'
88 | updateTaskVersion: true
89 |
--------------------------------------------------------------------------------
/.gitignore:
--------------------------------------------------------------------------------
1 | node_modules
2 | dist
3 | *.vsix
4 | *.log
--------------------------------------------------------------------------------
/LICENSE:
--------------------------------------------------------------------------------
1 | MIT License
2 |
3 | Copyright (c) Microsoft Corporation. All rights reserved.
4 |
5 | Permission is hereby granted, free of charge, to any person obtaining a copy
6 | of this software and associated documentation files (the "Software"), to deal
7 | in the Software without restriction, including without limitation the rights
8 | to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
9 | copies of the Software, and to permit persons to whom the Software is
10 | furnished to do so, subject to the following conditions:
11 |
12 | The above copyright notice and this permission notice shall be included in all
13 | copies or substantial portions of the Software.
14 |
15 | THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
16 | IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
17 | FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
18 | AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
19 | LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
20 | OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
21 | SOFTWARE.
22 |
--------------------------------------------------------------------------------
/SECURITY.md:
--------------------------------------------------------------------------------
1 |
2 |
3 | ## Security
4 |
5 | Microsoft takes the security of our software products and services seriously, which includes all source code repositories managed through our GitHub organizations, which include [Microsoft](https://github.com/microsoft), [Azure](https://github.com/Azure), [DotNet](https://github.com/dotnet), [AspNet](https://github.com/aspnet), [Xamarin](https://github.com/xamarin), and [our GitHub organizations](https://opensource.microsoft.com/).
6 |
7 | If you believe you have found a security vulnerability in any Microsoft-owned repository that meets [Microsoft's definition of a security vulnerability](https://aka.ms/opensource/security/definition), please report it to us as described below.
8 |
9 | ## Reporting Security Issues
10 |
11 | **Please do not report security vulnerabilities through public GitHub issues.**
12 |
13 | Instead, please report them to the Microsoft Security Response Center (MSRC) at [https://msrc.microsoft.com/create-report](https://aka.ms/opensource/security/create-report).
14 |
15 | If you prefer to submit without logging in, send email to [secure@microsoft.com](mailto:secure@microsoft.com). If possible, encrypt your message with our PGP key; please download it from the [Microsoft Security Response Center PGP Key page](https://aka.ms/opensource/security/pgpkey).
16 |
17 | You should receive a response within 24 hours. If for some reason you do not, please follow up via email to ensure we received your original message. Additional information can be found at [microsoft.com/msrc](https://aka.ms/opensource/security/msrc).
18 |
19 | Please include the requested information listed below (as much as you can provide) to help us better understand the nature and scope of the possible issue:
20 |
21 | * Type of issue (e.g. buffer overflow, SQL injection, cross-site scripting, etc.)
22 | * Full paths of source file(s) related to the manifestation of the issue
23 | * The location of the affected source code (tag/branch/commit or direct URL)
24 | * Any special configuration required to reproduce the issue
25 | * Step-by-step instructions to reproduce the issue
26 | * Proof-of-concept or exploit code (if possible)
27 | * Impact of the issue, including how an attacker might exploit the issue
28 |
29 | This information will help us triage your report more quickly.
30 |
31 | If you are reporting for a bug bounty, more complete reports can contribute to a higher bounty award. Please visit our [Microsoft Bug Bounty Program](https://aka.ms/opensource/security/bounty) page for more details about our active programs.
32 |
33 | ## Preferred Languages
34 |
35 | We prefer all communications to be in English.
36 |
37 | ## Policy
38 |
39 | Microsoft follows the principle of [Coordinated Vulnerability Disclosure](https://aka.ms/opensource/security/cvd).
40 |
41 |
42 |
--------------------------------------------------------------------------------
/azure-devops-extension.json:
--------------------------------------------------------------------------------
1 | {
2 | "public": false,
3 | "manifestVersion": 1,
4 | "id": "WSJF-extension",
5 | "publisher": "MS-Agile-SAFe",
6 | "version": "1.2.0",
7 | "name": "WSJF (Weighted Shortest Job First)",
8 | "description": "Auto calculates WSJF (weighted shortest job first) per work item and stores it in a work item field.",
9 | "categories": [
10 | "Azure Boards"
11 | ],
12 | "tags": [
13 | "WSJF",
14 | "SAFe"
15 | ],
16 | "targets": [
17 | {
18 | "id": "Microsoft.VisualStudio.Services"
19 | }
20 | ],
21 | "contributions": [
22 | {
23 | "id": "wsjf-work-item-form-observer",
24 | "type": "ms.vss-work-web.work-item-notifications",
25 | "description": "Update the 'WSJF' field when other fields on the form change.",
26 | "targets": [
27 | "ms.vss-work-web.work-item-form"
28 | ],
29 | "properties": {
30 | "uri": "wsjf.html"
31 | }
32 | },
33 | {
34 | "id": "wsjf-settings-hub",
35 | "type": "ms.vss-web.hub",
36 | "description": "Collection level settings experience for managing fields used to calculate WSJF.",
37 | "targets": [
38 | "ms.vss-web.collection-admin-hub-group"
39 | ],
40 | "properties": {
41 | "name": "WSJF",
42 | "uri": "wsjfSettings.html"
43 | }
44 | },
45 | {
46 | "id": "wsjf-contextMenu",
47 | "type": "ms.vss-web.action",
48 | "description": "Work item context menu action to update the WSJF field value for the selected work items.",
49 | "targets": [
50 | "ms.vss-work-web.work-item-context-menu"
51 | ],
52 | "properties": {
53 | "text": "Recalculate WSJF values",
54 | "title": "Update the WSJF value for the selected work items",
55 | "icon": "images/icon-refresh.png",
56 | "groupId": "SAFe",
57 | "uri": "wsjf.html"
58 | }
59 | }
60 | ],
61 | "files": [
62 | {
63 | "path": "css",
64 | "addressable": true
65 | },
66 | {
67 | "path": "marketplace",
68 | "addressable": true
69 | },
70 | {
71 | "path": "images",
72 | "addressable": true
73 | },
74 | {
75 | "path": "dist",
76 | "addressable": true,
77 | "packagePath": "scripts"
78 | },
79 | {
80 | "path": "wsjf.html",
81 | "addressable": true
82 | },
83 | {
84 | "path": "wsjfSettings.html",
85 | "addressable": true
86 | },
87 | {
88 | "path": "node_modules/vss-web-extension-sdk/lib",
89 | "addressable": true,
90 | "packagePath": "lib"
91 | }
92 | ],
93 | "scopes": [
94 | "vso.work",
95 | "vso.work_write"
96 | ],
97 | "icons": {
98 | "default": "images/logo.png"
99 | },
100 | "content": {
101 | "details": {
102 | "path": "marketplace/details.md"
103 | },
104 | "license": {
105 | "path": "LICENSE"
106 | }
107 | },
108 | "links": {
109 | "support": {
110 | "uri": "https://github.com/Microsoft/vsts-wsjf-extension/issues"
111 | }
112 | },
113 | "repository": {
114 | "type": "git",
115 | "uri": "https://github.com/Microsoft/vsts-wsjf-extension"
116 | },
117 | "branding": {
118 | "color": "rgb(220, 235, 252)",
119 | "theme": "light"
120 | },
121 | "demands": [
122 | "api-version/3.0"
123 | ]
124 | }
--------------------------------------------------------------------------------
/configs/dev.json:
--------------------------------------------------------------------------------
1 | {
2 | "public": false,
3 | "id": "WSJF-extension-dev",
4 | "name": "WSJF (Weighted Shortest Job First) (dev)"
5 | }
--------------------------------------------------------------------------------
/configs/release.json:
--------------------------------------------------------------------------------
1 | {
2 | "galleryFlags": [
3 | "Public"
4 | ],
5 | "public": true
6 | }
--------------------------------------------------------------------------------
/configs/test.json:
--------------------------------------------------------------------------------
1 | {
2 | "public": false,
3 | "id": "WSJF-extension-test",
4 | "name": "WSJF (Weighted Shortest Job First) (test)"
5 | }
--------------------------------------------------------------------------------
/css/wsjfSettings.css:
--------------------------------------------------------------------------------
1 | .description-text, .description-image {
2 | margin-left: 20px;
3 | padding-bottom: 20px;
4 | }
5 |
6 | .menu-bar {
7 | overflow: hidden;
8 | margin: 0 10px;
9 | border-top: 1px solid #ccc;
10 | border-bottom: 1px solid #ccc;
11 | font: 12px Segoe UI,Helvetica Neue,Helvetica,Arial,Verdana;
12 | color: #1e1e1e;
13 |
14 | }
15 |
16 | .settings-control {
17 | margin-top: 20px;
18 | margin-left: 20px;
19 | }
20 |
21 | .settings-control .combo {
22 | width: 400px;
23 | }
--------------------------------------------------------------------------------
/images/icon-refresh.png:
--------------------------------------------------------------------------------
https://raw.githubusercontent.com/microsoft/AzureDevOps-WSJF-Extension/e98959cdd5f1f2fa0ac16528733347e2da35f341/images/icon-refresh.png
--------------------------------------------------------------------------------
/images/logo.png:
--------------------------------------------------------------------------------
https://raw.githubusercontent.com/microsoft/AzureDevOps-WSJF-Extension/e98959cdd5f1f2fa0ac16528733347e2da35f341/images/logo.png
--------------------------------------------------------------------------------
/marketplace/AutoCalcWSJF.gif:
--------------------------------------------------------------------------------
https://raw.githubusercontent.com/microsoft/AzureDevOps-WSJF-Extension/e98959cdd5f1f2fa0ac16528733347e2da35f341/marketplace/AutoCalcWSJF.gif
--------------------------------------------------------------------------------
/marketplace/RecalculateWSJF.png:
--------------------------------------------------------------------------------
https://raw.githubusercontent.com/microsoft/AzureDevOps-WSJF-Extension/e98959cdd5f1f2fa0ac16528733347e2da35f341/marketplace/RecalculateWSJF.png
--------------------------------------------------------------------------------
/marketplace/WSJF-Setting.png:
--------------------------------------------------------------------------------
https://raw.githubusercontent.com/microsoft/AzureDevOps-WSJF-Extension/e98959cdd5f1f2fa0ac16528733347e2da35f341/marketplace/WSJF-Setting.png
--------------------------------------------------------------------------------
/marketplace/WSJF-create-fields.png:
--------------------------------------------------------------------------------
https://raw.githubusercontent.com/microsoft/AzureDevOps-WSJF-Extension/e98959cdd5f1f2fa0ac16528733347e2da35f341/marketplace/WSJF-create-fields.png
--------------------------------------------------------------------------------
/marketplace/WSJF-used-values.png:
--------------------------------------------------------------------------------
https://raw.githubusercontent.com/microsoft/AzureDevOps-WSJF-Extension/e98959cdd5f1f2fa0ac16528733347e2da35f341/marketplace/WSJF-used-values.png
--------------------------------------------------------------------------------
/marketplace/WSJF_on_form.png:
--------------------------------------------------------------------------------
https://raw.githubusercontent.com/microsoft/AzureDevOps-WSJF-Extension/e98959cdd5f1f2fa0ac16528733347e2da35f341/marketplace/WSJF_on_form.png
--------------------------------------------------------------------------------
/marketplace/details.md:
--------------------------------------------------------------------------------
1 | # WSJF (Weighted Shortest Job First)
2 |
3 | Weighted Shortest Job First (WSJF) is a prioritization technique used in the Scaled Agile Framework (SAFe) to sequence work items based on their economic impact and size. It calculates the Cost of Delay (considering user value, time criticality, and risk reduction/opportunity enablement) divided by the job size to determine priority. WSJF helps teams maximize ROI by ensuring the most valuable tasks are tackled first, fostering efficient resource allocation and decision-making in agile environments.
4 |
5 | # Documentation
6 |
7 | The [Scaled Agile Framework](http://www.scaledagileframework.com) defines [WSJF (Weighted Shortest Job First)](http://www.scaledagileframework.com/wsjf/) as a calculation of cost of delay vs. job size which can help teams prioritize their portfolio backlogs with the items contributing the highest ROI.
8 |
9 | 
10 |
11 | ### The values used to calculate WSJF
12 |
13 | - Business Value
14 | - Time Criticality
15 | - Risk Reduction | Opportunity Enablement
16 | - Job Size (Effort)
17 |
18 | ### The steps below shows how to configure and use the WSJF extension
19 |
20 | 1. Create Fields
21 |
22 | - The first thing you need is to create the fields that will store the RR-OE and WSJF values. Create a custom decimal field through the process hub and add it to the work items you want to display WSJF data on.
23 | 
24 |
25 | 2. Configure WSJF
26 |
27 | - Navigate to the "WSJF" hub in the organisation settings. From here, you must specify the fields that will be used for Business Value, Time Criticality, Job Size and WSJF. The first three are defaulted to the fields provided out of the box by Microsoft but can be changed to custom fields if you prefer.
28 | 
29 |
30 | 3. Auto calculated WSJF field on the form
31 |
32 | - WSJF is automatically updated when the form is loaded.
33 | - WSJF is automatically updated when the Business Value, Time Criticality, Effort, or Risk Reduction fields are updated.
34 | 
35 |
36 | 4. Recalculate WSJF context menu item
37 |
38 | - Update WSJF for all selected work items on the backlog or query grid.
39 | 
40 |
41 | _NOTE: If you're using Azure DevOps Server, you need to use witadmin to [Create a custom decimal field](https://www.visualstudio.com/en-us/docs/work/customize/add-modify-field#to-add-a-custom-field)_
42 |
43 | ## Adding RROE and WSJF Score Values (For Azure DevOps Server)
44 |
45 | Export your WorkItem.XML file (ie. Epic.XML) using [WITAdmin](https://learn.microsoft.com/en-us/previous-versions/azure/devops/reference/witadmin/witadmin-import-export-manage-wits?view=tfs-2018)
46 | At the bottom of your "Fields" section add the following (Name and reference names may vary):
47 |
48 | ```xml
49 |