Package Exports

This package does not declare an exports field, so the exports above have been automatically detected and optimized by JSPM instead. If any package subpath is missing, it is recommended to post an issue to the original package (tln-pm) to support the "exports" field. If that is not possible, create a JSPM override to customize the exports field for this package.

Readme

tpm - Project Management as Code

tpm tackles several challenges faced in modern software development:

Development and project management tools are often housed in separate systems like GitHub and Jira. This separation can result in wasted development resources due to the need for continuous synchronization. tpm expands GitOps to include project management, offering a single source of truth for all software development lifecycle activities.
Keeping project status up-to-date can be challenging and often requires setting up and maintaining a BI subsystem within the project management system. tpm automatically generates all reports and statistics directly from the repository, up to the latest commit
Managing multiple software projects, especially when resources are shared, is inherently challenging and often causes numerous issues with timelines and estimates. tpm offers a comprehensive overview, or "eagle's view", of any number of projects.

Dashboard

Approach (GitOps + PM)

tpm:

Employs a Git repository to store all SDLC artifacts.
Automatically generates essential project management artifacts.
Estimates new tasks based on completed ones.
Expands the SDLC to allow AI agents to participate in the software development process.

Dashboard

Demo project

Run next docker command to see tpm in action using test project

docker run -it -p 5445:5445 --rm vladyslavkurmaz/sh.tln.pm:0.22.0

Open next link in browser
```
http://localhost:5445
```

Quick start

Note : `Windows has its own tpm utility. To prevent conflicts, the Talan CLI is available as *tpmw on Windows`

Install Nodejs 20.x or higher (https://nodejs.org)
Install tpm
```
npm i -g tln-pm@0.22.0
```
Navigate to your project's Git repository root folder and set up the initial configuration
```
tpm config --project --team --timeline --tasks
```

Update .tpm.conf with your project's details, including team structure, timeline, and tasks. Ensure that the emails used for tpm configuration match toyr dev team emails.

project:
  id: myproject
  name: My Project
  description: My project description
team:
  alice.c:
    email: alice.c@gmail.com
    name: Alice Clarke
timeline:
  25.9.0:
    deadline: '2025-09-28T18:00:00.000Z'
tasks: |
  [>:002:25.9.0] Integrate auth library @alice.c
    [!] Add /iam/auth endpoint #16h
    [>] Configure auth callbacks #4h
  [-:001:25.9.0] Create project structure #16h @alice.c

Now you can start managing your project using cli and git

Command	Description
tpm ls --backlog	Display tasks are in backlog for current git user (you)
tpm ls -g alice.c	Display tasks in development were assigned to the Alice
tpm ls -g alice.c --backlog	List of tasks are in Alice backlog

The following command will provide a high-level "eagle view" of your project in the browser http://localhost:5445
```
tpm serve
```

Task statuses & attributes

Task can be described in multiple forms depends on requirements

Example	Description
[-:010:25.2.0] Task with release version	This format should be used for top level task with specific deadline
[-:001] Task with Id	Top level task but without delivery version
[-] Simple task with description only	This format is useful for subtasks

First symbol in square brackets describes status of the task

Symbol Meaning CLI option

- todo --todo

> in development --dev

! blocked --blocked

+ done --done

Symbol	Meaning	CLI option
-	todo	--todo
>	in development	--dev
!	blocked	--blocked
+	done	--done

Mentionings, Tags, Links

A lightweight DSL may be included in the task title to enrich it with additional context and details

@alex.m - assigns the task to Alex
#backend - adds the backend tag to the task
#16h - sets the time estimate for the task to 16 hours

[-:021:25.9.2] Add Sonarcloud into CI/CD #4h @vlad.k #devops

Command line options

Note : `Use tln --help for more details`

tpm [ls | config | inspect | update | normalise | spillover | serve | audit] [component] [id] [optios]

Command (parameters & options)	Default	Description
tpm ls		Display list of tasks for current git user
tpm ls --backlog	false	Display list of tasks for current git user are waiting for completion
tpm ls --todo	false	Display list of tasks for current git user in development
tpm ls --dev	true	Display list of tasks for current git user in development
tpm ls --done	true	Display list of tasks for current git user which were aleady completed
tpm ls -g alice.c	git user	Display tasks in developmenr were assigned to the specific user
tpm ls -a	false	Display tasks are in development for all users
tpm ls -t backend		Display tasks with 'backend' tag
tpm ls -s cognito		Display tasks with 'cognito' string in title

tpm config --project --team --timeline --tasks --doc --components		Generate example .tpm.conf

tpm inspect		Show details about component
tpm inspect . 013		Show details about task woth id - 013 for current component

tpm update backend 017 --done		Mark task with id - 017 inside backend component as done

tpm normalise platform/premise 001		Ensure task statuses are synchronized recursively and consistently
tpm spillover web/libs --deadlines 25.9.2:25.9.3 --save		Spill over all tasks under web/libs component from 25.9.2 release to 25.9.3 and update configs

tpm serve		Launch a local web server to explore project details through the browser

tpm audit		Perform a comprehensive project audit covering multiple dimensions — including unassigned tasks, blocked work, and other critical metrics

DSL

Available sections

project:
  id: myproject
  name: My Project
  description: My project description
team:
  alice.c:
    email: alice.c@gmail.com
    name: Alice Clarke
timeline:
  25.1.0:
    deadline: '2025-01-31T18:00:00.000Z'
tasks: |
  [>:002:25.1.0] Integrate auth library @alice.c
    [!] Add /iam/auth endpoint
    [>] Configure auth callbacks
  [-:001:25.1.0] Create project structure @alice.c
components:
  backend:
    tasks: |
      [-:002] Integrate Sonarcloud
      [+:001] Add service skeleton + unit tests
  web:
    tasks: |
      [-:002] Integrate Sonarcloud
      [>:001] Add landing skeleton using Next.js