@beauraines/sprint-tracker 0.6.1

package/R/sprintOutcomesCli.R

@@ -0,0 +1,103 @@
+library(tidyverse)
+library(ggplot2)
+
+# sqlite3 --header --csv tracker.db < sql/sprintOutcomes.sql > /tmp/outcomes.csv
+
+outcomes = read_csv('/tmp/outcomes.csv')
+
+outcomes <- outcomes %>% 
+  tibble() %>%
+  filter(story_points != 0) %>%
+  mutate(
+    end_date = as.Date(end_date)
+  )
+
+# compute velocity statistics
+
+entire_project_velocity = (outcomes %>% 
+                             filter(outcome == 'B-Delivered' ) %>% 
+                             summarize( average_velocity = mean(story_points)))$average_velocity
+
+average_velocity = (outcomes %>% 
+                      filter(outcome == 'B-Delivered') %>%
+                      filter(!sprint_name  %in% c('Accessibility Improvement 0','Accessibility Improvements 1')) %>%
+                      summarize( average_velocity = mean(story_points)))$average_velocity
+
+# Compute 95% band velocity
+
+outcomeColors = c("A-Commitment" = "#0B4F6C",
+                 "Carryover" = "#D34E24",
+                 "Carryover - External" = "#d3248d",
+                 "Descoped" ="#A39BA8",
+                 "Unplanned - Bug" ="#F28123",
+                 "Unplanned - Story" = "#F7F052",
+                 "B-Delivered" ="#00A878")
+outcomeFills = c("A-Commitment" = "#0B4F6C",
+                 "Carryover" = "#D34E24",
+                 "Carryover - External" = "#d3248d",
+                 "Descoped" ="#A39BA8",
+                 "Unplanned - Bug" ="#F28123",
+                 "Unplanned - Story" = "#F7F052",
+                 "B-Delivered" ="#00A878")
+
+chartTitle = str_c("Sprint Outcomes - ",unique(outcomes$project_name))
+
+plot<-ggplot(outcomes,
+             aes(fill=outcome,
+                 y=story_points,
+                 # x=end_date
+                 #x = str_wrap(sprint_name,15)
+                 x = reorder(str_wrap(sprint_name,15),end_date)
+                 )
+             )+
+  geom_bar(position="dodge", stat="identity",color = "black") +
+  # add bar labels
+  geom_text(data = outcomes %>% mutate(story_points = na_if(story_points,0)),
+            aes(label=story_points, y = story_points + .5),
+            position = position_dodge(0.9)) +
+  # trendline
+  geom_smooth(aes(#x=factor(end_date),
+                  x=factor(reorder(str_wrap(sprint_name,15),end_date)),
+                  y=story_points,group=outcome),
+              data = outcomes%>%filter(outcome=="B-Delivered"),
+              #method = "lm", # no method = curved line
+              se=FALSE,
+              show.legend = FALSE,
+              linetype = "dashed",
+              color = "#00A878") +
+  # TODO better position this annotation
+  annotate(geom="text",
+           x=length(unique(outcomes$sprint_name))+.25,
+           y=average_velocity + 1.5,
+           label="Trend Line") +
+  # average velocity line
+  geom_hline(yintercept=average_velocity,linetype = "dotted", color = "#00A878") +
+  annotate(geom="text", x=.75, y=average_velocity + 1.5, label="Average\nVelocity") +
+  # plot labels
+  labs(title=chartTitle,
+       # subtitle = 'Excluding the Data Science, Product Ownership and QA Teams',
+       x ="", 
+       y = "Story Points", 
+       fill='Outcomes') +
+  #colors
+  scale_colour_manual(values = outcomeColors) + 
+  scale_fill_manual(values = outcomeFills) +
+  #themes
+  theme(
+    plot.title = element_text(family = "roboto"),
+    axis.title.x = element_text(family = "roboto"),
+    axis.text.x = element_text(angle = 45, vjust = 1, hjust=1),
+    axis.title.y = element_text(family = "roboto"),
+    panel.grid.major.y = element_line(colour = "#D9D9D9"), panel.grid.minor.y = element_line(colour = "#D9D9D9"),
+    panel.grid.major.x = element_blank(), panel.grid.minor.x = element_blank(),
+    # background color 
+    panel.background = element_rect(fill = "#D9D9D920", colour = NA),
+    legend.position = "bottom",
+    plot.background = element_rect(colour = "#D9D9D9", fill=NA)
+  ) 
+
+# plot # commented out for docker
+
+ggsave(str_c("~/projects/sprint-tracker/",str_replace(unique(outcomes$project_name)," ",""),"SprintOutcomesCli.png"),plot=plot,bg="white", width = 2882, height = 1700, units =  "px")
+
+print(str_c("Saving to ",str_c("~/projects/sprint-tracker/",str_replace(unique(outcomes$project_name)," ",""),"SprintOutcomesCli.png"),sep = " "))

package/R/sprintOutcomesFeatureTeam.R

@@ -0,0 +1,143 @@
+library(tidyverse)
+library(ggplot2)
+
+# sqlite3 --header --csv tracker.db < sprint_outcomes.sql > /tmp/outcomes.csv
+
+library(DBI)
+library(RSQLite)
+con <- dbConnect(RSQLite::SQLite(),"~/projects/sprint-tracker/tracker.db")
+
+res <- dbSendQuery(con, "-- SQLite
+SELECT 
+    p.name project_name,
+    s.id sprint_id,
+    s.sprint_name,
+    s.end_date,
+    case
+        when o.name = 'Commitment' then 'A-Commitment'
+        when o.name = 'Delivered' then 'B-Delivered'
+        else o.name
+    end outcome,
+    -- s.commited_points,
+    -- so.issue_count,
+    -- so.story_points,
+    ifnull(so.story_points, so.issue_count) AS story_points -- accounts for unpointed bug stories
+
+from projects p
+
+JOIN sprints s on s.project_id = p.id
+JOIN sprint_outcomes so on so.sprint_id = s.id
+JOIN outcomes o on o.id = so.outcome_id
+
+WHERE
+  -- p.id = 10 -- Helo Project Team
+  p.id = 11 -- Feature Team One
+
+")
+
+
+# TODO query sqlite directly
+outcomes <- dbFetch(res)
+
+# Clear the result
+dbClearResult(res)
+
+# Disconnect from the database
+dbDisconnect(con)
+
+outcomes <- outcomes %>% 
+  tibble() %>%
+  filter(story_points != 0) %>%
+  mutate(
+    end_date = as.Date(end_date)
+  )
+
+# compute velocity statistics
+
+entire_project_velocity = (outcomes %>% 
+                             filter(outcome == 'B-Delivered' ) %>% 
+                             summarize( average_velocity = mean(story_points)))$average_velocity
+
+average_velocity = (outcomes %>% 
+                      filter(outcome == 'B-Delivered') %>%
+                      filter(!sprint_name  %in% c('Accessibility Improvement 0','Accessibility Improvements 1')) %>%
+                      summarize( average_velocity = mean(story_points)))$average_velocity
+
+# Compute 95% band velocity
+
+outcomeColors = c("A-Commitment" = "#0B4F6C",
+                 "Carryover" = "#D34E24",
+                 "Carryover - External" = "#d3248d",
+                 "Descoped" ="#A39BA8",
+                 "Unplanned - Bug" ="#F28123",
+                 "Unplanned - Story" = "#F7F052",
+                 "B-Delivered" ="#00A878")
+outcomeFills = c("A-Commitment" = "#0B4F6C",
+                 "Carryover" = "#D34E24",
+                 "Carryover - External" = "#d3248d",
+                 "Descoped" ="#A39BA8",
+                 "Unplanned - Bug" ="#F28123",
+                 "Unplanned - Story" = "#F7F052",
+                 "B-Delivered" ="#00A878")
+
+chartTitle = str_c("Sprint Outcomes - ",unique(outcomes$project_name))
+
+plot<-ggplot(outcomes,
+             aes(fill=outcome,
+                 y=story_points,
+                 # x=end_date
+                 #x = str_wrap(sprint_name,15)
+                 x = reorder(str_wrap(sprint_name,15),end_date)
+                 )
+             )+
+  geom_bar(position="dodge", stat="identity",color = "black") +
+  # add bar labels
+  geom_text(data = outcomes %>% mutate(story_points = na_if(story_points,0)),
+            aes(label=story_points, y = story_points + .5),
+            position = position_dodge(0.9)) +
+  # trendline
+  geom_smooth(aes(#x=factor(end_date),
+                  x=factor(reorder(str_wrap(sprint_name,15),end_date)),
+                  y=story_points,group=outcome),
+              data = outcomes%>%filter(outcome=="B-Delivered"),
+              #method = "lm", # no method = curved line
+              se=FALSE,
+              show.legend = FALSE,
+              linetype = "dashed",
+              color = "#00A878") +
+  # TODO better position this annotation
+  annotate(geom="text",
+           x=length(unique(outcomes$sprint_name))+.25,
+           y=average_velocity + 1.5,
+           label="Trend Line") +
+  # average velocity line
+  geom_hline(yintercept=average_velocity,linetype = "dotted", color = "#00A878") +
+  annotate(geom="text", x=.75, y=average_velocity + 1.5, label="Average\nVelocity") +
+  # plot labels
+  labs(title=chartTitle,
+       # subtitle = 'Excluding the Data Science, Product Ownership and QA Teams',
+       x ="", 
+       y = "Story Points", 
+       fill='Outcomes') +
+  #colors
+  scale_colour_manual(values = outcomeColors) + 
+  scale_fill_manual(values = outcomeFills) +
+  #themes
+  theme(
+    plot.title = element_text(family = "roboto"),
+    axis.title.x = element_text(family = "roboto"),
+    axis.text.x = element_text(angle = 45, vjust = 1, hjust=1),
+    axis.title.y = element_text(family = "roboto"),
+    panel.grid.major.y = element_line(colour = "#D9D9D9"), panel.grid.minor.y = element_line(colour = "#D9D9D9"),
+    panel.grid.major.x = element_blank(), panel.grid.minor.x = element_blank(),
+    # background color 
+    panel.background = element_rect(fill = "#D9D9D920", colour = NA),
+    legend.position = "bottom",
+    plot.background = element_rect(colour = "#D9D9D9", fill=NA)
+  ) 
+
+# plot # commented out for docker
+
+ggsave(str_c("~/projects/sprint-tracker/",str_replace(unique(outcomes$project_name)," ",""),"SprintOutcomes.png"),plot=plot,bg="white", width = 2882, height = 1700, units =  "px")
+
+print(str_c("Saving to ",str_c("~/projects/sprint-tracker/",str_replace(unique(outcomes$project_name)," ",""),"SprintOutcomes.png"),sep = " "))

package/R/timeInCodeReview.R

@@ -0,0 +1,157 @@
+library(tidyverse)
+library(lubridate)
+library(ggplot2)
+
+
+# json2csv -i Sprint12Transitions.json --unwind changelog --flatten-objects -o Sprint12Transitions.csv
+
+# transitions = read_csv('~/projects/sprint-tracker/Sprint12Transitions.csv') %>%
+transitions = read_csv('~/projects/sprint-tracker/code-review/transitions.csv') %>%
+  rename(timestamp = changelog.timestamp,
+         from = changelog.transition.from,
+         to = changelog.transition.to) %>%
+  mutate(transition = str_c(from,to,sep="-")) %>% 
+  filter(str_detect(key,"ACDC"))
+
+
+# single = transitions %>%
+#   filter(key == 'ACDC-250') %>%
+#   filter(transition %in% c("In Progress-Code Review","Code Review-QA Review")) %>%
+#   pivot_wider(id_cols = c(key,summary),
+#               names_from = transition,
+#               values_from = timestamp) %>%
+#   mutate(
+#     duration = `Code Review-QA Review` - `In Progress-Code Review`
+#   )
+
+ time_in_code_review = transitions %>%
+  filter(transition %in% c("In Progress-Code Review","Code Review-QA Review")) %>%
+  pivot_wider(id_cols = c(sprint,key,summary),
+              names_from = transition,
+              values_from = timestamp,
+              # the min function is to get the earliest transition
+              values_fn = min) %>%
+   relocate(`In Progress-Code Review`,.after=summary) %>%
+  mutate(
+    duration = difftime(`Code Review-QA Review`,`In Progress-Code Review`,units = "days")
+  ) 
+
+summary = time_in_code_review %>% 
+  group_by(sprint) %>%
+  summarise(mean = mean(duration,na.rm=TRUE),
+            min = min(duration,na.rm=TRUE),
+            max=max(duration,na.rm=TRUE),
+            sd=sd(duration,na.rm=TRUE),
+            count = n()
+            )
+print(summary)
+
+summary %>% 
+  filter(sprint != 'Bulk Assign API') %>%
+  pivot_longer(
+    # cols = c(mean_time,max_time,min_time),
+    cols = c(mean,max,min),
+    names_to = "statistic",
+    values_to = "days",
+    values_transform = as.numeric
+  ) %>% 
+  select(sprint,statistic,days) %>%
+  # filter(statistic=="mean") %>%
+  ggplot(
+    aes(x=reorder(sprint,as.numeric(str_extract(sprint,"[0-9]+"))),
+        y=days,
+        color=statistic, 
+        group = statistic)
+    ) +
+    geom_point() +
+    geom_line() +
+  labs(title="Time in Code Review", x ="", y = "Days") +
+  theme(
+    plot.title = element_text(family = "roboto"),
+    axis.title.x = element_text(family = "roboto"),
+    axis.text.x = element_text(angle = 45, vjust = 1, hjust=1),
+    axis.title.y = element_text(family = "roboto"),
+    panel.grid.major.y = element_line(colour = "#D9D9D9"), panel.grid.minor.y = element_line(colour = "#D9D9D9"),
+    panel.grid.major.x = element_blank(), panel.grid.minor.x = element_blank(),
+    # background color 
+    panel.background = element_rect(fill = "#D9D9D920", colour = NA),
+    legend.position = "bottom",
+    plot.background = element_rect(colour = "#D9D9D9", fill=NA)
+  ) 
+
+
+mean_code_review = mean(time_in_code_review$duration,na.rm=TRUE)
+meet_SLA = time_in_code_review %>% filter(duration <= 1 ) %>% count() %>% pull()
+percent_meet_SLA = (meet_SLA/count(time_in_code_review)) %>% pull()
+
+time_in_code_review %>% 
+  filter(sprint != 'Bulk Assign API') %>%
+  ggplot(
+  aes(x=reorder(sprint,as.numeric(str_extract(sprint,"[0-9]+"))),
+      y=duration)
+) +
+  geom_point()+
+  geom_jitter()+
+  geom_hline(yintercept = 1, color = "red") +
+  labs(title="Time in Code Review",
+       subtitle = "1 day SLA",
+       x ="",
+       y = "Days") +
+  annotate(geom="text",
+           x=1,
+           y=9,
+           hjust = 0,
+           color = "red",
+           label=str_c(scales::label_percent()(percent_meet_SLA)," meet 1 day SLA for review")) +
+  theme(
+    plot.title = element_text(family = "roboto"),
+    axis.title.x = element_text(family = "roboto"),
+    axis.text.x = element_text(angle = 45, vjust = 1, hjust=1),
+    axis.title.y = element_text(family = "roboto"),
+    panel.grid.major.y = element_line(colour = "#D9D9D9"), panel.grid.minor.y = element_line(colour = "#D9D9D9"),
+    panel.grid.major.x = element_blank(), panel.grid.minor.x = element_blank(),
+    # background color 
+    panel.background = element_rect(fill = "#D9D9D920", colour = NA),
+    legend.position = "bottom",
+    plot.background = element_rect(colour = "#D9D9D9", fill=NA)
+  ) 
+
+ggsave("~/projects/sprint-tracker/time_in_code_review.png",bg="white", width = 2882, height = 1700, units =  "px")
+
+
+time_in_code_review %>% 
+  filter(sprint != 'Bulk Assign API') %>% 
+  ggplot(aes(x=duration)) + 
+  geom_histogram(binwidth=1,color="black", fill="white") +
+  stat_bin(binwidth=1, 
+           geom="text", 
+           colour="black", 
+           size=3.5,
+           aes(label=..count..), 
+           position=position_stack(vjust=0.5)) +
+  # geom_density(alpha=.2, fill="#FF6666") +
+  scale_x_continuous(minor_breaks = seq(1, 20, 1),
+                     # limits=c(0,15)
+                     ) +
+  labs(title="Time in Code Review",
+       subtitle = "Histogram of 1 day buckets",
+       x ="",
+       y = "Days") +
+  theme(
+    plot.title = element_text(family = "roboto"),
+    axis.title.x = element_text(family = "roboto"),
+    # axis.text.x = element_text(angle = 45, vjust = 1, hjust=1),
+    axis.title.y = element_text(family = "roboto"),
+    panel.grid.major.y = element_line(colour = "#D9D9D9"), 
+    panel.grid.minor.y = element_line(colour = "#D9D9D9"),
+    panel.grid.major.x = element_line(colour = "#D9D9D9"), 
+    panel.grid.minor.x = element_line(colour = "#D9D9D9"),
+    # background color 
+    panel.background = element_rect(fill = "#D9D9D920", colour = NA),
+    legend.position = "bottom",
+    plot.background = element_rect(colour = "#D9D9D9", fill=NA)
+  ) 
+
+ggsave("~/projects/sprint-tracker/time_in_code_review_histogram.png",bg="white", width = 2882, height = 1700, units =  "px")
+
+

package/README.md

@@ -0,0 +1,181 @@
+Sprint Tracker
+===============
+
+Collects sprint outcome information and generates a visualization of sprint outcomes.
+
+## Visualizations
+
+Using the `visualization` command, you can generate a sprint outcome and velocity visualization. An example is shown below, with sprint names across the bottom. For each sprint, it compares the commitment and delivered story points, as well as some information about stories added and removed from the sprint.
+
+
+![](./DFSprintOutcomesCli.png)
+
+## Command Information
+
+```
+sprint-tracker <cmd> [args]
+
+Commands:
+  sprint-tracker addOutcome        Menu driven process to add outcomes to a
+                                   sprint
+  sprint-tracker addProject        Prompts to add a new project to the database
+  sprint-tracker addSprint         Prompts to add a new sprint to an existing
+                                   project
+  sprint-tracker config            Creates a config file, prompting for required
+                                   inputs
+  sprint-tracker getSprint         Gets sprint details
+  sprint-tracker visualizations    Creates Feature Team visualizations with R.
+                                   Must have docker, rstudio-tidyverse container
+                                   and more installed
+  sprint-tracker create-database   Creates and initializes the empty database
+                                   specified in the config
+  sprint-tracker upgrade-database  Upgrades database with new structure
+  sprint-tracker completion        Outputs bash/zsh-completion shortcuts for
+                                   commands and options to add to .bashrc or
+                                   .bash_profile
+
+Options:
+  --version  Show version number                                       [boolean]
+  --help     Show help                                                 [boolean]
+```
+## Dependencies
+
+This CLI application relies on a local [sqlite](https://www.sqlite.org/download.html) database, [docker](https://docs.docker.com/desktop/?_gl=1*ogftl2*_ga*OTE5MjI3MDc1LjE3MDE5MDA5NTE.*_ga_XJWPQMJYHQ*MTcwMTkwMDk1MS4xLjEuMTcwMTkwMDk5My4xOC4wLjA.), and the [rocker](https://hub.docker.com/r/rocker/tidyverse)/tidyverse](https://hub.docker.com/r/rocker/tidyverse) image to function. Installation of these dependencies is outside of the scope of this project as the steps vary by OS.
+
+On Mac, these can be installed with homebrew.
+
+```bash
+brew install docker sqlite
+docker pull rocker/tidyverse
+```
+
+## General Usage
+
+1. Update the config file with the path to the database `sprint-tracker config`. The database doesn't need to exist yet. This step only needs to be done the first time.
+7. Create the database and run the migrations `sprint-tracker create-database`. This step only needs to be done the first time.
+8. Run `sprint-tracker addProject` to add a project to the database. This step can be repeated as new projects are started.
+9.  Add the first sprint with `sprint-tracker addSprint` optionally, adding the sprint commitment. This step can be repeated for subsequent sprints.
+10. At the end of the sprint, record sprint outcomes `sprint-tracker addOutcome`. This will allow you to log information about stories and points completed, committed, pulled forward, carried over, and bugs.
+11. Generate the cumulative sprint outcomes visualization with `sprint-tracker visualizations`. If you do not have the [rocker/tidyverse](https://hub.docker.com/r/rocker/tidyverse) image, it will automatically pull it, which will take a little bit of time
+
+
+## Configuration
+
+A configuration file `~/sprintTracker.json` is required  with the full path to your tracker database
+
+```json
+{
+    "database":"/Users/beauraines/projects/sprint-tracker/tracker.db"
+}
+```
+
+## Installation and Setup for Development
+
+1. Clone the repository
+2. Ensure you have sqlite3 and docker installed. See [Dependencies](#dependencies).
+3. Install npm dependencies `npm i`
+4. Globally install the sprint tracker `npm -g i`
+5. Follow the [General Usage](#general-usage) instructions.
+
+## Tracking Outcomes
+
+### Project
+
+This table will store project master data.
+
+
+### Sprint
+Sprint details including the dates and original commitment. The original commitment will not change and can be sourced from the Jira "Velocity Report" for the sprint.
+
+Non-working days and PTO will be recorded to be able to normalize Sprints with different durations.
+
+
+### Sprint Outcomes
+
+1. Commitment : Initial sprint commitment
+1. Delivered : Work completed this sprint
+1. Unplanned - Story : All unplanned work brought into the sprint, whether completed or not
+1. Unplanned - Bug : Unplanned work without a pre-existing story that was deemed critical enough to add to the sprint
+1. Descoped : Committed work, removed from the sprint
+1. Carryover : Incomplete, started or unstarted, work from this sprint, assumed that it will carryover to the next sprint
+1. Carryover - External : Work that was carried over due to blockers external to the scrum team. Use of this is optional, as an agile team should be fully self-sufficient.
+
+
+### ERD
+
+```mermaid
+erDiagram
+    PROJECTS {
+        int id 
+        string name
+        string pm_name
+        string pm_email
+        string client
+        string project_number
+        date start_date
+        date end_date
+
+    }
+    SPRINTS {
+        int id
+        int project_id
+        string sprint_name
+        date start_date
+        date end_date
+        number committed_points
+        number committed_stories
+        number non_working_days
+        number developers
+        number developer_pto_days
+    }
+
+    SPRINT_OUTCOMES {
+        int id 
+        int sprint_id
+        int outcome_id
+        int issue_count
+        int story_points
+        text notes    
+    }
+
+    OUTCOMES {
+        int  id
+        string  name
+        text    description
+    }
+
+    PROJECTS ||--o{ SPRINTS : ""
+    SPRINTS ||--|{ SPRINT_OUTCOMES : ""
+    OUTCOMES ||--o{ SPRINT_OUTCOMES: ""
+```
+
+
+
+## Generating Visualizations with R and Docker
+
+There are several R scripts included in the project repository, more than just the sprint outcomes. They can be run from the command line using docker and the `rocker/tidyverse` image as shown below.
+
+```bash
+# PROJECT_DIR must have trailing slash
+PROJECT_DIR=/Users/beauraines/projects/
+IMAGE=rocker/tidyverse
+docker run -it --rm -v ${PROJECT_DIR}:/home/rstudio/projects/ ${IMAGE} su -c 'Rscript /home/rstudio/projects/sprint-tracker/R/sprintOutcomes.R' rstudio
+```
+
+## Roadmap
+
+1. ~~Build local database using sqlite3~~
+2. ~~Script visualizations, possibly with R, graph-cli, chartsjs, PowerBI or AWS QuickSight~~
+3. [Backlog health tracking](https://github.com/beauraines/sprint-tracker/issues/36)
+4. Write API for adding data
+5. Write API for getting visualizations
+6. ~~Create database migrations~~
+7. Deploy to cloud
+8. Add sprint metrics
+    1. Average velocity over life of project
+    2. Recent average velocity
+    3.  90% confidence range. See <https://resources.scrumalliance.org/Article/its-target-forecast>
+    4.  Daily points per developer
+
+
+

package/cli.js

@@ -0,0 +1,55 @@
+#!/usr/bin/env node
+
+require('yargs')
+  .scriptName("sprint-tracker")
+  .usage('$0 <cmd> [args]')
+  .commandDir('cmds')
+  .command({
+    command: 'create-database',
+    desc: 'Creates and initializes the empty database specified in the config',
+    handler: async () => {
+      var sqlite3 = require('sqlite3').verbose();
+      let {CommandsRunner, SQLite3Driver} = require('node-db-migration');
+      const {homedir} = require('os');
+      const {readConfig} = require('./utils/readConfig.js')
+      const path = require('path');
+
+      const filename = 'sprintTracker.json'
+      const configFile = path.join(homedir(),filename)
+      const config = await readConfig(configFile)
+      const database = config.database
+      var db = new sqlite3.Database(database);
+      let migrations = new CommandsRunner({
+          driver: new SQLite3Driver(db),
+          directoryWithScripts: __dirname + '/migrations',
+      });
+      await migrations.run('init')
+      await migrations.run('migrate')
+    }
+  })
+  .command({
+    command: 'upgrade-database',
+    desc: 'Upgrades database with new structure',
+    handler: async () => {
+      var sqlite3 = require('sqlite3').verbose();
+      let {CommandsRunner, SQLite3Driver} = require('node-db-migration');
+      const {homedir} = require('os');
+      const {readConfig} = require('./utils/readConfig.js')
+      const path = require('path');
+
+      const filename = 'sprintTracker.json'
+      const configFile = path.join(homedir(),filename)
+      const config = await readConfig(configFile)
+      const database = config.database
+      var db = new sqlite3.Database(database);
+      let migrations = new CommandsRunner({
+          driver: new SQLite3Driver(db),
+          directoryWithScripts: __dirname + '/migrations',
+      });
+      await migrations.run('migrate')
+    }
+  })
+  .completion('completion', 'Outputs bash/zsh-completion shortcuts for commands and options to add to .bashrc or .bash_profile')
+  .demandCommand()
+  .help()
+  .argv