project-roadmap-tracking 0.2.0 → 0.2.1

package/README.md

@@ -15,7 +15,7 @@ A modern, production-ready CLI tool for managing project tasks and roadmaps with
 - 🔍 **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 98.78% test coverage
+- 🏗️ **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
 
@@ -166,7 +166,7 @@ $ npm install -g project-roadmap-tracking
 $ prt COMMAND
 running command...
 $ prt (--version)
-project-roadmap-tracking/0.2.0 darwin-arm64 node-v24.12.0
+project-roadmap-tracking/0.2.1 darwin-arm64 node-v25.2.1
 $ prt --help [COMMAND]
 USAGE
   $ prt COMMAND
@@ -228,7 +228,7 @@ EXAMPLES
   $ prt add
 ```
 
-_See code: [src/commands/add.ts](https://github.com/ZacharyEggert/project-roadmap-tracking/blob/v0.2.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`
 
@@ -253,7 +253,7 @@ EXAMPLES
   $ prt complete F-001 --tests
 ```
 
-_See code: [src/commands/complete.ts](https://github.com/ZacharyEggert/project-roadmap-tracking/blob/v0.2.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]`
 
@@ -300,7 +300,7 @@ EXAMPLES
   $ prt init [path/to/directory]
 ```
 
-_See code: [src/commands/init.ts](https://github.com/ZacharyEggert/project-roadmap-tracking/blob/v0.2.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`
 
@@ -329,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.2.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`
 
@@ -353,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.2.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`
 
@@ -667,7 +667,7 @@ EXAMPLES
   $ prt show F-001
 ```
 
-_See code: [src/commands/show.ts](https://github.com/ZacharyEggert/project-roadmap-tracking/blob/v0.2.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`
 
@@ -676,7 +676,7 @@ Update a task in place
 ```
 USAGE
   $ prt update TASKID [--clear-notes] [-d <value>] [--no-repo] [-n <value>] [-s
-    completed|in-progress|not-started] [-t true|false] [-v]
+    completed|in-progress|not-started] [-t true|false] [--type bug|feature|improvement|planning|research] [-v]
 
 ARGUMENTS
   TASKID  ID of the task to update
@@ -691,6 +691,8 @@ FLAGS
   -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
@@ -701,7 +703,7 @@ 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.2.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`
 
@@ -722,7 +724,7 @@ EXAMPLES
   $ prt validate
 ```
 
-_See code: [src/commands/validate.ts](https://github.com/ZacharyEggert/project-roadmap-tracking/blob/v0.2.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
@@ -769,7 +771,7 @@ prt COMMAND
 
 ### Testing
 
-PRT has comprehensive test coverage (98.78%):
+PRT has comprehensive test coverage (96.81%):
 
 - **Unit tests**: Services, repositories, utilities, errors
 - **Command tests**: All CLI commands
@@ -795,10 +797,10 @@ yarn test:coverage:summary
 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 (99.89% coverage)
-- ✓ Repository pattern with caching and file watching (96.06% coverage)
+- ✓ 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 (98.78% overall coverage)
+- ✓ Comprehensive test suite (96.81% overall coverage)
 - ✓ Backward compatible legacy mode
 
 ### Contributing

package/dist/commands/update.d.ts

@@ -12,6 +12,7 @@ export default class Update extends Command {
         notes: import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
         status: import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
         tested: import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
+        type: import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
         verbose: import("@oclif/core/interfaces").BooleanFlag<boolean>;
     };
     run(): Promise<void>;

package/dist/commands/update.js

@@ -2,9 +2,10 @@ 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 { STATUS } from '../util/types.js';
+import { STATUS, TASK_TYPE } from '../util/types.js';
 import { updateTaskInRoadmap } from '../util/update-task.js';
 import { validateTaskID } from '../util/validate-task-id.js';
 import { writeRoadmapFile } from '../util/write-roadmap.js';
@@ -38,6 +39,10 @@ export default class Update extends Command {
             description: 'update whether the task passes tests',
             options: ['true', 'false'],
         }),
+        type: Flags.string({
+            description: 'update the task type (reassigns task ID and cascades to all references)',
+            options: [TASK_TYPE.Bug, TASK_TYPE.Feature, TASK_TYPE.Improvement, TASK_TYPE.Planning, TASK_TYPE.Research],
+        }),
         verbose: Flags.boolean({
             char: 'v',
             default: false,
@@ -56,6 +61,23 @@ export default class Update extends Command {
             const roadmap = flags['no-repo']
                 ? await readRoadmapFile(config.path)
                 : await RoadmapRepository.fromConfig(config).load(config.path);
+            // Handle type update separately since it requires ID reassignment and cascading
+            if (flags.type) {
+                const newType = flags.type;
+                const oldTaskId = args.taskID;
+                const { newTaskId, roadmap: updatedRoadmap } = taskService.updateTaskType(roadmap, oldTaskId, newType);
+                await (flags['no-repo']
+                    ? writeRoadmapFile(config.path, updatedRoadmap)
+                    : RoadmapRepository.fromConfig(config).save(config.path, updatedRoadmap));
+                if (newTaskId === oldTaskId) {
+                    this.log(`Task ${oldTaskId} was already of type ${newType}. No changes made.`);
+                }
+                else {
+                    this.log(`Task ${oldTaskId} has been updated to type ${newType} with new ID ${newTaskId}.`);
+                    this.log(`All task references to ${oldTaskId} have been updated to ${newTaskId}.`);
+                }
+                return;
+            }
             const updateObject = {};
             if (flags['clear-notes']) {
                 updateObject.notes = '';

package/dist/repositories/config.repository.js

@@ -1,4 +1,4 @@
-import { Ajv } from 'ajv';
+import Ajv from 'ajv';
 import { readFile, stat } from 'node:fs/promises';
 import { homedir } from 'node:os';
 import { join } from 'node:path';
@@ -76,7 +76,7 @@ export class ConfigRepository {
             searchPaths: config?.searchPaths ?? this.getDefaultSearchPaths(),
         };
         // Initialize JSON schema validator
-        const ajv = new Ajv({ allErrors: true, strict: false });
+        const ajv = new Ajv({ allErrors: true });
         this.validateSchema = ajv.compile(ConfigRepository.configSchema);
     }
     /**
@@ -237,7 +237,7 @@ export class ConfigRepository {
                     ]);
                 }
                 const errorDetails = this.validateSchema.errors.map((err) => ({
-                    field: err.instancePath || 'config',
+                    field: err.dataPath || 'config',
                     message: err.message || 'Unknown error',
                     type: 'structure',
                 }));

package/dist/services/task.service.d.ts

@@ -117,6 +117,29 @@ export declare class TaskService {
      * ```
      */
     updateTask(roadmap: Roadmap, taskId: string, updates: Partial<Task>): Roadmap;
+    /**
+     * Updates a task's type, reassigning its ID and cascading the change to all references.
+     * When a task type is changed, a new ID is generated to match the new type prefix.
+     * All other tasks that reference the old ID in their depends-on or blocks arrays
+     * will be updated to reference the new ID.
+     *
+     * @param roadmap - The roadmap containing the task to update
+     * @param taskId - The current ID of the task to update
+     * @param newType - The new task type to assign
+     * @returns An object containing the updated Roadmap and the new task ID
+     * @throws Error if the task with the given ID is not found
+     *
+     * @example
+     * ```typescript
+     * // Change task F-001 to a bug (will become B-001 or next available B-XXX)
+     * const {roadmap: updatedRoadmap, newTaskId} = taskService.updateTaskType(roadmap, 'F-001', TASK_TYPE.Bug);
+     * // All tasks that had 'F-001' in depends-on or blocks will now have the new bug ID
+     * ```
+     */
+    updateTaskType(roadmap: Roadmap, taskId: string, newType: TASK_TYPE): {
+        newTaskId: TaskID;
+        roadmap: Roadmap;
+    };
 }
 /**
  * Default export instance of TaskService for convenience.

package/dist/services/task.service.js

@@ -159,6 +159,66 @@ export class TaskService {
             tasks: [...roadmap.tasks.slice(0, taskIndex), updatedTask, ...roadmap.tasks.slice(taskIndex + 1)],
         };
     }
+    /**
+     * Updates a task's type, reassigning its ID and cascading the change to all references.
+     * When a task type is changed, a new ID is generated to match the new type prefix.
+     * All other tasks that reference the old ID in their depends-on or blocks arrays
+     * will be updated to reference the new ID.
+     *
+     * @param roadmap - The roadmap containing the task to update
+     * @param taskId - The current ID of the task to update
+     * @param newType - The new task type to assign
+     * @returns An object containing the updated Roadmap and the new task ID
+     * @throws Error if the task with the given ID is not found
+     *
+     * @example
+     * ```typescript
+     * // Change task F-001 to a bug (will become B-001 or next available B-XXX)
+     * const {roadmap: updatedRoadmap, newTaskId} = taskService.updateTaskType(roadmap, 'F-001', TASK_TYPE.Bug);
+     * // All tasks that had 'F-001' in depends-on or blocks will now have the new bug ID
+     * ```
+     */
+    updateTaskType(roadmap, taskId, newType) {
+        const task = this.findTask(roadmap, taskId);
+        if (!task) {
+            throw new TaskNotFoundError(taskId);
+        }
+        // If the type isn't changing, just return the roadmap unchanged with the same task ID
+        if (task.type === newType) {
+            return { newTaskId: taskId, roadmap };
+        }
+        // Generate a new ID for the new type
+        const newTaskId = this.generateNextId(roadmap, newType);
+        // Update the task with the new type and new ID
+        let updatedRoadmap = this.updateTask(roadmap, taskId, {
+            id: newTaskId,
+            type: newType,
+        });
+        // Cascade the ID change to all tasks that reference the old ID
+        updatedRoadmap = {
+            ...updatedRoadmap,
+            tasks: updatedRoadmap.tasks.map((t) => {
+                // Skip the task we just updated
+                if (t.id === newTaskId) {
+                    return t;
+                }
+                // Check if this task references the old ID in depends-on or blocks
+                const hasDependency = t['depends-on'].includes(taskId);
+                const hasBlock = t.blocks.includes(taskId);
+                if (!hasDependency && !hasBlock) {
+                    return t;
+                }
+                // Update the references
+                return {
+                    ...t,
+                    blocks: hasBlock ? t.blocks.map((id) => (id === taskId ? newTaskId : id)) : t.blocks,
+                    'depends-on': hasDependency ? t['depends-on'].map((id) => (id === taskId ? newTaskId : id)) : t['depends-on'],
+                    updatedAt: new Date().toISOString(),
+                };
+            }),
+        };
+        return { newTaskId, roadmap: updatedRoadmap };
+    }
 }
 /**
  * Default export instance of TaskService for convenience.

package/oclif.manifest.json

@@ -470,6 +470,20 @@
           ],
           "type": "option"
         },
+        "type": {
+          "description": "update the task type (reassigns task ID and cascades to all references)",
+          "name": "type",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "options": [
+            "bug",
+            "feature",
+            "improvement",
+            "planning",
+            "research"
+          ],
+          "type": "option"
+        },
         "verbose": {
           "char": "v",
           "description": "show detailed error information including stack traces",
@@ -531,5 +545,5 @@
       ]
     }
   },
-  "version": "0.2.0"
+  "version": "0.2.1"
 }

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "project-roadmap-tracking",
   "description": "CLI based project task tracking",
-  "version": "0.2.0",
+  "version": "0.2.1",
   "author": "ZacharyEggert",
   "bin": {
     "prt": "./bin/run.js"
@@ -44,7 +44,15 @@
   ],
   "homepage": "https://github.com/ZacharyEggert/project-roadmap-tracking",
   "keywords": [
-    "oclif"
+    "oclif",
+		"cli",
+		"project",
+		"roadmap",
+		"tracking",
+		"tasks",
+		"productivity",
+		"management",
+		"prt"
   ],
   "license": "MIT",
   "main": "dist/index.js",