project-roadmap-tracking 0.1.0 → 0.2.1

package/README.md

@@ -1,15 +1,161 @@
 # project-roadmap-tracking
 
-CLI based project task tracking
+A modern, production-ready CLI tool for managing project tasks and roadmaps with advanced features like dependency tracking, validation, and comprehensive test coverage.
 
 [![oclif](https://img.shields.io/badge/cli-oclif-brightgreen.svg)](https://oclif.io)
 [![Version](https://img.shields.io/npm/v/project-roadmap-tracking.svg)](https://npmjs.org/package/project-roadmap-tracking)
 [![Downloads/week](https://img.shields.io/npm/dw/project-roadmap-tracking.svg)](https://npmjs.org/package/project-roadmap-tracking)
 
+## Features
+
+- 📝 **Task Management**: Create, update, and track bugs, features, improvements, planning tasks, and research items
+- 🔗 **Dependency Tracking**: Define task dependencies and detect circular dependencies
+- 🎯 **Priority & Status**: Organize tasks by priority (high/medium/low) and status (not-started/in-progress/completed)
+- ✅ **Test Tracking**: Mark tasks as passing tests to maintain quality
+- 🔍 **Powerful Filtering**: Filter and sort tasks by multiple criteria
+- 📊 **Validation**: Comprehensive roadmap validation with detailed error reporting
+- ⚡ **Performance**: LRU caching and file watching for optimal performance
+- 🏗️ **Modern Architecture**: Service layer, repository pattern, and 96.81% test coverage
+- 📦 **Configuration**: Multi-level config inheritance (project → user → global)
+- 🔄 **Backward Compatible**: Legacy mode via `--no-repo` flag
+
+## Quick Start
+
+### Installation
+
+```bash
+npm install -g project-roadmap-tracking
+```
+
+### Initialize a Project
+
+```bash
+# Initialize with sample tasks
+prt init --name "My Project" --withSampleTasks
+
+# Or create an empty roadmap
+prt init --name "My Project"
+```
+
+### Basic Usage
+
+```bash
+# Add a new feature
+prt add "User authentication" -t feature -d "Implement JWT auth" -p high
+
+# List all high-priority tasks
+prt list -p high
+
+# Show task details
+prt show F-001
+
+# Update task status
+prt update F-001 --status=in-progress
+
+# Complete a task
+prt complete F-001 --tests
+
+# Validate roadmap integrity
+prt validate
+```
+
+## Architecture
+
+PRT follows a modern layered architecture:
+
+- **CLI Layer**: Thin command handlers using oclif
+- **Service Layer**: Business logic (TaskService, RoadmapService, etc.)
+- **Repository Layer**: Data access with caching and file watching
+- **Error Handling**: Custom error hierarchy with error codes
+
+For detailed architecture documentation, see [ARCHITECTURE.md](ARCHITECTURE.md).
+
+## Data Format
+
+PRT uses two JSON files to manage your project:
+
+### `.prtrc.json` (Configuration)
+Project configuration with optional caching settings:
+
+```json
+{
+  "$schema": "https://raw.githubusercontent.com/ZacharyEggert/project-roadmap-tracking/master/schemas/config/v1.1.json",
+  "name": "My Project",
+  "description": "Project description",
+  "path": "./prt.json",
+  "cache": {
+    "enabled": true,
+    "maxSize": 10
+  }
+}
+```
+
+### `prt.json` (Roadmap)
+Your tasks and project data:
+
+```json
+{
+  "$schema": "https://raw.githubusercontent.com/ZacharyEggert/project-roadmap-tracking/master/schemas/roadmap/v1.json",
+  "metadata": {
+    "name": "My Project",
+    "createdAt": "2026-01-22T10:00:00.000Z"
+  },
+  "tasks": [
+    {
+      "id": "F-001",
+      "title": "User authentication",
+      "type": "feature",
+      "status": "in-progress",
+      "priority": "high",
+      "details": "Implement JWT authentication",
+      "tags": ["auth", "security"],
+      "depends-on": [],
+      "blocks": [],
+      "passes-tests": false,
+      "createdAt": "2026-01-22T10:00:00.000Z",
+      "updatedAt": "2026-01-22T10:00:00.000Z"
+    }
+  ]
+}
+```
+
+### Task ID Format
+
+Task IDs follow the pattern `{TYPE}-{NUMBER}`:
+- **B-001**: Bug
+- **F-001**: Feature
+- **I-001**: Improvement
+- **P-001**: Planning
+- **R-001**: Research
+
+IDs are auto-generated sequentially per task type.
+
 <!-- toc -->
 * [project-roadmap-tracking](#project-roadmap-tracking)
+* [Initialize with sample tasks](#initialize-with-sample-tasks)
+* [Or create an empty roadmap](#or-create-an-empty-roadmap)
+* [Add a new feature](#add-a-new-feature)
+* [List all high-priority tasks](#list-all-high-priority-tasks)
+* [Show task details](#show-task-details)
+* [Update task status](#update-task-status)
+* [Complete a task](#complete-a-task)
+* [Validate roadmap integrity](#validate-roadmap-integrity)
 * [Usage](#usage)
 * [Commands](#commands)
+* [Clone the repository](#clone-the-repository)
+* [Install dependencies](#install-dependencies)
+* [Build the project](#build-the-project)
+* [Run tests](#run-tests)
+* [Run tests with coverage](#run-tests-with-coverage)
+* [Run linter](#run-linter)
+* [Auto-fix linting issues](#auto-fix-linting-issues)
+* [Format code](#format-code)
+* [Run CLI locally without installing](#run-cli-locally-without-installing)
+* [Link for global development testing](#link-for-global-development-testing)
+* [Run all tests](#run-all-tests)
+* [Run a specific test file](#run-a-specific-test-file)
+* [Generate coverage report](#generate-coverage-report)
+* [View coverage summary](#view-coverage-summary)
 <!-- tocstop -->
 
 # Usage
@@ -20,7 +166,7 @@ $ npm install -g project-roadmap-tracking
 $ prt COMMAND
 running command...
 $ prt (--version)
-project-roadmap-tracking/0.1.0 darwin-arm64 node-v25.2.1
+project-roadmap-tracking/0.2.1 darwin-arm64 node-v25.2.1
 $ prt --help [COMMAND]
 USAGE
   $ prt COMMAND
@@ -57,8 +203,8 @@ add a new task to the roadmap
 
 ```
 USAGE
-  $ prt add TITLE -d <value> -t bug|feature|improvement|planning|research [-p high|medium|low] [-s
-    not-started|in-progress|completed] [-g <value>]
+  $ prt add TITLE -d <value> -t bug|feature|improvement|planning|research [--no-repo] [-p
+    high|medium|low] [-s not-started|in-progress|completed] [-g <value>] [-v]
 
 ARGUMENTS
   TITLE  title of the task to add
@@ -72,6 +218,8 @@ FLAGS
                            <options: not-started|in-progress|completed>
   -t, --type=<option>      (required) type of the task to add
                            <options: bug|feature|improvement|planning|research>
+  -v, --verbose            show detailed error information including stack traces
+      --no-repo            use legacy direct file I/O instead of repository pattern
 
 DESCRIPTION
   add a new task to the roadmap
@@ -80,7 +228,7 @@ EXAMPLES
   $ prt add
 ```
 
-_See code: [src/commands/add.ts](https://github.com/ZacharyEggert/project-roadmap-tracking/blob/v0.1.0/src/commands/add.ts)_
+_See code: [src/commands/add.ts](https://github.com/ZacharyEggert/project-roadmap-tracking/blob/v0.2.1/src/commands/add.ts)_
 
 ## `prt complete TASKID`
 
@@ -88,13 +236,15 @@ Mark a task as completed
 
 ```
 USAGE
-  $ prt complete TASKID [-t]
+  $ prt complete TASKID [--no-repo] [-t] [-v]
 
 ARGUMENTS
   TASKID  ID of the task to complete
 
 FLAGS
-  -t, --tests  mark task as passes-tests
+  -t, --tests    mark task as passes-tests
+  -v, --verbose  show detailed error information including stack traces
+      --no-repo  use legacy direct file I/O instead of repository pattern
 
 DESCRIPTION
   Mark a task as completed
@@ -103,7 +253,7 @@ EXAMPLES
   $ prt complete F-001 --tests
 ```
 
-_See code: [src/commands/complete.ts](https://github.com/ZacharyEggert/project-roadmap-tracking/blob/v0.1.0/src/commands/complete.ts)_
+_See code: [src/commands/complete.ts](https://github.com/ZacharyEggert/project-roadmap-tracking/blob/v0.2.1/src/commands/complete.ts)_
 
 ## `prt help [COMMAND]`
 
@@ -131,7 +281,7 @@ initialize a new project roadmap (prt.json and prt.config.json)
 
 ```
 USAGE
-  $ prt init [FOLDER] [-d <value>] [-f] [-n <value>] [--withSampleTasks]
+  $ prt init [FOLDER] [-d <value>] [-f] [-n <value>] [-v] [--withSampleTasks]
 
 ARGUMENTS
   [FOLDER]  folder to initialize the project roadmap in
@@ -140,6 +290,7 @@ FLAGS
   -d, --description=<value>  description to print
   -f, --force                force initialization even if files already exist
   -n, --name=<value>         name to print
+  -v, --verbose              show detailed error information including stack traces
       --withSampleTasks      include sample tasks in the initialized roadmap
 
 DESCRIPTION
@@ -149,7 +300,7 @@ EXAMPLES
   $ prt init [path/to/directory]
 ```
 
-_See code: [src/commands/init.ts](https://github.com/ZacharyEggert/project-roadmap-tracking/blob/v0.1.0/src/commands/init.ts)_
+_See code: [src/commands/init.ts](https://github.com/ZacharyEggert/project-roadmap-tracking/blob/v0.2.1/src/commands/init.ts)_
 
 ## `prt list`
 
@@ -157,8 +308,8 @@ list tasks in the project roadmap
 
 ```
 USAGE
-  $ prt list [-i] [-p high|medium|low|h|m|l] [-o dueDate|priority|createdAt] [-s
-    completed|in-progress|not-started]
+  $ prt list [-i] [--no-repo] [-p high|medium|low|h|m|l] [-o dueDate|priority|createdAt] [-s
+    completed|in-progress|not-started] [-v]
 
 FLAGS
   -i, --incomplete         filter tasks to show in-progress and not-started only
@@ -168,6 +319,8 @@ FLAGS
                            <options: high|medium|low|h|m|l>
   -s, --status=<option>    filter tasks by status (completed, in-progress, not-started)
                            <options: completed|in-progress|not-started>
+  -v, --verbose            show detailed error information including stack traces
+      --no-repo            use legacy direct file I/O instead of repository pattern
 
 DESCRIPTION
   list tasks in the project roadmap
@@ -176,7 +329,7 @@ EXAMPLES
   $ prt list -p=h --incomplete --sort=createdAt
 ```
 
-_See code: [src/commands/list.ts](https://github.com/ZacharyEggert/project-roadmap-tracking/blob/v0.1.0/src/commands/list.ts)_
+_See code: [src/commands/list.ts](https://github.com/ZacharyEggert/project-roadmap-tracking/blob/v0.2.1/src/commands/list.ts)_
 
 ## `prt pass-test TASKID`
 
@@ -184,11 +337,15 @@ Mark a task as passes-tests
 
 ```
 USAGE
-  $ prt pass-test TASKID
+  $ prt pass-test TASKID [--no-repo] [-v]
 
 ARGUMENTS
   TASKID  ID of the task to mark as passing tests
 
+FLAGS
+  -v, --verbose  show detailed error information including stack traces
+      --no-repo  use legacy direct file I/O instead of repository pattern
+
 DESCRIPTION
   Mark a task as passes-tests
 
@@ -196,7 +353,7 @@ EXAMPLES
   $ prt pass-test F-001
 ```
 
-_See code: [src/commands/pass-test.ts](https://github.com/ZacharyEggert/project-roadmap-tracking/blob/v0.1.0/src/commands/pass-test.ts)_
+_See code: [src/commands/pass-test.ts](https://github.com/ZacharyEggert/project-roadmap-tracking/blob/v0.2.1/src/commands/pass-test.ts)_
 
 ## `prt plugins`
 
@@ -494,11 +651,15 @@ show details of a specific task in the project roadmap
 
 ```
 USAGE
-  $ prt show TASK
+  $ prt show TASK [--no-repo] [-v]
 
 ARGUMENTS
   TASK  task ID to show
 
+FLAGS
+  -v, --verbose  show detailed error information including stack traces
+      --no-repo  use legacy direct file I/O instead of repository pattern
+
 DESCRIPTION
   show details of a specific task in the project roadmap
 
@@ -506,7 +667,7 @@ EXAMPLES
   $ prt show F-001
 ```
 
-_See code: [src/commands/show.ts](https://github.com/ZacharyEggert/project-roadmap-tracking/blob/v0.1.0/src/commands/show.ts)_
+_See code: [src/commands/show.ts](https://github.com/ZacharyEggert/project-roadmap-tracking/blob/v0.2.1/src/commands/show.ts)_
 
 ## `prt update TASKID`
 
@@ -514,8 +675,8 @@ Update a task in place
 
 ```
 USAGE
-  $ prt update TASKID [--clear-notes] [-d <value>] [-n <value>] [-s completed|in-progress|not-started] [-t
-    true|false]
+  $ prt update TASKID [--clear-notes] [-d <value>] [--no-repo] [-n <value>] [-s
+    completed|in-progress|not-started] [-t true|false] [--type bug|feature|improvement|planning|research] [-v]
 
 ARGUMENTS
   TASKID  ID of the task to update
@@ -527,7 +688,11 @@ FLAGS
                          <options: completed|in-progress|not-started>
   -t, --tested=<option>  update whether the task passes tests
                          <options: true|false>
+  -v, --verbose          show detailed error information including stack traces
       --clear-notes      clear all notes from the task
+      --no-repo          use legacy direct file I/O instead of repository pattern
+      --type=<option>    update the task type (reassigns task ID and cascades to all references)
+                         <options: bug|feature|improvement|planning|research>
 
 DESCRIPTION
   Update a task in place
@@ -538,22 +703,126 @@ EXAMPLES
   $ prt update F-002 --deps="F-001" --clear-notes
 ```
 
-_See code: [src/commands/update.ts](https://github.com/ZacharyEggert/project-roadmap-tracking/blob/v0.1.0/src/commands/update.ts)_
+_See code: [src/commands/update.ts](https://github.com/ZacharyEggert/project-roadmap-tracking/blob/v0.2.1/src/commands/update.ts)_
 
 ## `prt validate`
 
-describe the command here
+Validate roadmap structure, task data, and check for circular dependencies
 
 ```
 USAGE
-  $ prt validate
+  $ prt validate [--no-repo] [-v]
+
+FLAGS
+  -v, --verbose  show detailed error information including stack traces
+      --no-repo  use legacy direct file I/O instead of repository pattern
 
 DESCRIPTION
-  describe the command here
+  Validate roadmap structure, task data, and check for circular dependencies
 
 EXAMPLES
   $ prt validate
 ```
 
-_See code: [src/commands/validate.ts](https://github.com/ZacharyEggert/project-roadmap-tracking/blob/v0.1.0/src/commands/validate.ts)_
+_See code: [src/commands/validate.ts](https://github.com/ZacharyEggert/project-roadmap-tracking/blob/v0.2.1/src/commands/validate.ts)_
 <!-- commandsstop -->
+
+## Development
+
+### Setup
+
+```bash
+# Clone the repository
+git clone https://github.com/ZacharyEggert/project-roadmap-tracking.git
+cd project-roadmap-tracking
+
+# Install dependencies
+yarn install
+
+# Build the project
+yarn build
+```
+
+### Development Commands
+
+```bash
+# Run tests
+yarn test
+
+# Run tests with coverage
+yarn test:coverage:summary
+
+# Run linter
+yarn lint
+
+# Auto-fix linting issues
+yarn lint:fix
+
+# Format code
+yarn format
+
+# Run CLI locally without installing
+./bin/dev.js COMMAND
+
+# Link for global development testing
+yarn link
+prt COMMAND
+```
+
+### Testing
+
+PRT has comprehensive test coverage (96.81%):
+
+- **Unit tests**: Services, repositories, utilities, errors
+- **Command tests**: All CLI commands
+- **Test runner**: Mocha + Chai
+- **Coverage**: c8
+
+```bash
+# Run all tests
+yarn test
+
+# Run a specific test file
+yarn mocha --loader=tsx/esm "test/path/to/file.test.ts"
+
+# Generate coverage report
+yarn test:coverage
+
+# View coverage summary
+yarn test:coverage:summary
+```
+
+### Architecture
+
+For detailed architecture documentation, including design patterns, service layer architecture, repository pattern, and migration path, see [ARCHITECTURE.md](ARCHITECTURE.md).
+
+Key architectural features:
+- ✓ Service layer for business logic (97.43% coverage)
+- ✓ Repository pattern with caching and file watching (94.7% coverage)
+- ✓ Custom error hierarchy with error codes (100% coverage)
+- ✓ Comprehensive test suite (96.81% overall coverage)
+- ✓ Backward compatible legacy mode
+
+### Contributing
+
+See [CONTRIBUTING.md](CONTRIBUTING.md) for contribution guidelines.
+
+### Release Process
+
+1. Update version in `package.json`
+2. Run `yarn prepack` (generates manifest and updates README)
+3. Commit changes
+4. Run `yarn pack` to create tarball
+5. Run `npm publish` to publish to npm registry
+
+## License
+
+MIT
+
+## Links
+
+- [GitHub Repository](https://github.com/ZacharyEggert/project-roadmap-tracking)
+- [npm Package](https://www.npmjs.com/package/project-roadmap-tracking)
+- [Issues](https://github.com/ZacharyEggert/project-roadmap-tracking/issues)
+- [Architecture Documentation](ARCHITECTURE.md)
+- [Contributing Guidelines](CONTRIBUTING.md)

package/dist/commands/add.d.ts

@@ -7,10 +7,12 @@ export default class Add extends Command {
     static examples: string[];
     static flags: {
         details: import("@oclif/core/interfaces").OptionFlag<string, import("@oclif/core/interfaces").CustomOptions>;
+        'no-repo': import("@oclif/core/interfaces").BooleanFlag<boolean>;
         priority: import("@oclif/core/interfaces").OptionFlag<string, import("@oclif/core/interfaces").CustomOptions>;
         status: import("@oclif/core/interfaces").OptionFlag<string, import("@oclif/core/interfaces").CustomOptions>;
         tags: import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
         type: import("@oclif/core/interfaces").OptionFlag<string, import("@oclif/core/interfaces").CustomOptions>;
+        verbose: import("@oclif/core/interfaces").BooleanFlag<boolean>;
     };
     run(): Promise<void>;
 }

package/dist/commands/add.js

@@ -1,7 +1,11 @@
 import { Args, Command, Flags } from '@oclif/core';
+import { getDefaultConfigRepository } from '../repositories/config.repository.js';
+import { RoadmapRepository } from '../repositories/roadmap.repository.js';
+import errorHandlerService from '../services/error-handler.service.js';
+import taskService from '../services/task.service.js';
 import { readConfigFile } from '../util/read-config.js';
 import { readRoadmapFile } from '../util/read-roadmap.js';
-import { PRIORITY, STATUS, TASK_TYPE, TASK_TYPE_MAP } from '../util/types.js';
+import { PRIORITY, STATUS, TASK_TYPE } from '../util/types.js';
 import { writeRoadmapFile } from '../util/write-roadmap.js';
 export default class Add extends Command {
     static args = {
@@ -13,6 +17,10 @@ export default class Add extends Command {
         // force: Flags.boolean({char: 'f'}),
         // name: Flags.string({char: 'n', description: 'name to print'}),
         details: Flags.string({ char: 'd', description: 'description of the task to add', required: true }),
+        'no-repo': Flags.boolean({
+            default: false,
+            description: 'use legacy direct file I/O instead of repository pattern',
+        }),
         priority: Flags.string({
             char: 'p',
             default: PRIORITY.Medium,
@@ -38,39 +46,39 @@ export default class Add extends Command {
             options: [TASK_TYPE.Bug, TASK_TYPE.Feature, TASK_TYPE.Improvement, TASK_TYPE.Planning, TASK_TYPE.Research],
             required: true,
         }),
+        verbose: Flags.boolean({
+            char: 'v',
+            default: false,
+            description: 'show detailed error information including stack traces',
+        }),
     };
     async run() {
         const { args, flags } = await this.parse(Add);
-        const config = await readConfigFile();
-        const roadmapFile = await readRoadmapFile(config.path);
-        const taskType = flags.type;
-        const existingTaskIDs = new Set(roadmapFile.tasks.filter((task) => task.type === taskType).map((task) => task.id));
-        let newIDNumber = 1;
-        let newTaskID;
-        while (true) {
-            const potentialID = `${TASK_TYPE_MAP.get(taskType)}-${String(newIDNumber).padStart(3, '0')}`;
-            if (!existingTaskIDs.has(potentialID)) {
-                newTaskID = potentialID;
-                break;
-            }
-            newIDNumber++;
+        try {
+            // Use repository pattern by default, unless --no-repo flag is set
+            const config = flags['no-repo'] ? await readConfigFile() : await getDefaultConfigRepository().load();
+            const roadmap = flags['no-repo']
+                ? await readRoadmapFile(config.path)
+                : await RoadmapRepository.fromConfig(config).load(config.path);
+            const taskType = flags.type;
+            const newTaskID = taskService.generateNextId(roadmap, taskType);
+            const newTask = taskService.createTask({
+                details: flags.details,
+                id: newTaskID,
+                priority: flags.priority,
+                status: flags.status,
+                tags: flags.tags ? flags.tags.split(',').map((tag) => tag.trim()) : [],
+                title: args.title,
+                type: taskType,
+            });
+            const updatedRoadmap = taskService.addTask(roadmap, newTask);
+            await (flags['no-repo']
+                ? writeRoadmapFile(config.path, updatedRoadmap)
+                : RoadmapRepository.fromConfig(config).save(config.path, updatedRoadmap));
+        }
+        catch (error) {
+            const exitCode = errorHandlerService.handleError(error);
+            this.error(errorHandlerService.formatErrorMessage(error, flags.verbose), { exit: exitCode });
         }
-        const newTask = {
-            blocks: [],
-            createdAt: new Date().toISOString(),
-            'depends-on': [],
-            details: flags.details,
-            id: newTaskID,
-            notes: '',
-            'passes-tests': false,
-            priority: flags.priority,
-            status: flags.status,
-            tags: flags.tags ? flags.tags.split(',').map((tag) => tag.trim()) : [],
-            title: args.title,
-            type: taskType,
-            updatedAt: new Date().toISOString(),
-        };
-        roadmapFile.tasks.push(newTask);
-        await writeRoadmapFile(config.path, roadmapFile);
     }
 }

package/dist/commands/complete.d.ts

@@ -6,7 +6,9 @@ export default class Complete extends Command {
     static description: string;
     static examples: string[];
     static flags: {
+        'no-repo': import("@oclif/core/interfaces").BooleanFlag<boolean>;
         tests: import("@oclif/core/interfaces").BooleanFlag<boolean>;
+        verbose: import("@oclif/core/interfaces").BooleanFlag<boolean>;
     };
     run(): Promise<void>;
 }

package/dist/commands/complete.js

@@ -1,4 +1,7 @@
 import { Args, Command, Flags } from '@oclif/core';
+import { getDefaultConfigRepository } from '../repositories/config.repository.js';
+import { RoadmapRepository } from '../repositories/roadmap.repository.js';
+import errorHandlerService from '../services/error-handler.service.js';
 import { readConfigFile } from '../util/read-config.js';
 import { readRoadmapFile } from '../util/read-roadmap.js';
 import { STATUS } from '../util/types.js';
@@ -11,25 +14,45 @@ export default class Complete extends Command {
     static description = 'Mark a task as completed';
     static examples = ['<%= config.bin %> <%= command.id %> F-001 --tests'];
     static flags = {
+        'no-repo': Flags.boolean({
+            default: false,
+            description: 'use legacy direct file I/O instead of repository pattern',
+        }),
         // flag with no value (-f, --force)
         // force: Flags.boolean({char: 'f'}),
         // flag with a value (-n, --name=VALUE)
         // name: Flags.string({char: 'n', description: 'name to print'}),
         tests: Flags.boolean({ char: 't', description: 'mark task as passes-tests' }),
+        verbose: Flags.boolean({
+            char: 'v',
+            default: false,
+            description: 'show detailed error information including stack traces',
+        }),
     };
     async run() {
         const { args, flags } = await this.parse(Complete);
-        const config = await readConfigFile();
-        const roadmap = await readRoadmapFile(config.path);
-        const updatedRoadmap = await updateTaskInRoadmap(roadmap, args.taskID, flags.tests
-            ? {
-                'passes-tests': true,
-                status: STATUS.Completed,
-            }
-            : {
-                status: STATUS.Completed,
-            });
-        await writeRoadmapFile(config.path, updatedRoadmap);
-        this.log(`Task ${args.taskID} marked as completed.`);
+        try {
+            // Use repository pattern by default, unless --no-repo flag is set
+            const config = flags['no-repo'] ? await readConfigFile() : await getDefaultConfigRepository().load();
+            const roadmap = flags['no-repo']
+                ? await readRoadmapFile(config.path)
+                : await RoadmapRepository.fromConfig(config).load(config.path);
+            const updatedRoadmap = await updateTaskInRoadmap(roadmap, args.taskID, flags.tests
+                ? {
+                    'passes-tests': true,
+                    status: STATUS.Completed,
+                }
+                : {
+                    status: STATUS.Completed,
+                });
+            await (flags['no-repo']
+                ? writeRoadmapFile(config.path, updatedRoadmap)
+                : RoadmapRepository.fromConfig(config).save(config.path, updatedRoadmap));
+            this.log(`Task ${args.taskID} marked as completed.`);
+        }
+        catch (error) {
+            const exitCode = errorHandlerService.handleError(error);
+            this.error(errorHandlerService.formatErrorMessage(error, flags.verbose), { exit: exitCode });
+        }
     }
 }

package/dist/commands/init.d.ts

@@ -10,6 +10,7 @@ export default class Init extends Command {
         description: import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
         force: import("@oclif/core/interfaces").BooleanFlag<boolean>;
         name: import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
+        verbose: import("@oclif/core/interfaces").BooleanFlag<boolean>;
         withSampleTasks: import("@oclif/core/interfaces").BooleanFlag<boolean>;
     };
     buildBlankRoadmap({ description, name, withSampleTasks, }: {