claude-task-tracker 1.0.10 → 1.0.11

package/README.md

@@ -7,6 +7,7 @@ A CLI task tracker with dependency management designed to extend memory for agen
 - **Task Dependencies**: Blocking dependencies that prevent task execution until completed
 - **Soft References**: Non-blocking references between related tasks
 - **Task Overviews**: Context summaries filled on completion for dependent tasks to reference
+- **Plan File References**: Link tasks to external plan files with detailed implementation notes
 - **Ready Task Detection**: `next` command finds tasks ready to work on (open + all blockers completed)
 - **Multiple Output Formats**: Default, JSON, and compact (token-efficient for LLMs)
 - **Claude Code Integration**: Auto-generates `CLAUDE.md` with usage instructions on init
@@ -47,6 +48,9 @@ ctt add "Design API schema" -d "Define REST endpoints"
 ctt add "Implement auth" --blocked-by t1
 ctt add "Write tests" --blocked-by t2 --ref t1
 
+# Add a task with a plan file
+ctt add "Refactor database" -p .tasks/plans/db-refactor.md
+
 # Get next ready task
 ctt next
 # Output: t1 - Design API schema
@@ -66,7 +70,7 @@ ctt context t2
 | Command | Description |
 |---------|-------------|
 | `ctt init` | Initialize `.tasks/tasks.json` in current directory |
-| `ctt add <title>` | Add task (`-d` description, `-b` blockedBy, `-r` refs) |
+| `ctt add <title>` | Add task (`-d` description, `-b` blockedBy, `-r` refs, `-p` planFile) |
 | `ctt list` | List all tasks (`-s` filter by status) |
 | `ctt show <id>` | Show task details |
 | `ctt next` | Get next ready task (open + all blockers completed) |
@@ -78,6 +82,7 @@ ctt context t2
 | `ctt unref <id> --to <id>` | Remove soft reference |
 | `ctt context <id>` | Show task + all dependency overviews |
 | `ctt overview <id> <text>` | Update task overview |
+| `ctt plan <id> <path>` | Set or update plan file reference |
 | `ctt delete <id>` | Delete a task |
 | `ctt cleanup` | Remove old completed tasks (`-d` days, default 7, `--dry-run`) |
 
@@ -126,6 +131,7 @@ ctt --compact context t3
 - `<t1,t2` = blocked by t1 and t2
 - `~t1` = references t1
 - `>text` = overview
+- `@path` = plan file reference
 
 ## Task States
 

package/dist/index.js

@@ -20,6 +20,7 @@ function createTask(id, title, options = {}) {
     blockedBy: options.blockedBy ?? [],
     references: options.references ?? [],
     overview: void 0,
+    planFile: options.planFile,
     createdAt: now,
     updatedAt: now
   };
@@ -135,6 +136,9 @@ function formatTaskDetail(task, store) {
   if (task.overview) {
     lines.push(`Overview:    ${task.overview}`);
   }
+  if (task.planFile) {
+    lines.push(`Plan file:   ${task.planFile}`);
+  }
   lines.push(`Created:     ${task.createdAt}`);
   lines.push(`Updated:     ${task.updatedAt}`);
   return lines.join("\n");
@@ -197,6 +201,9 @@ function formatTaskCompact(task) {
   if (task.overview) {
     parts.push(`>${task.overview}`);
   }
+  if (task.planFile) {
+    parts.push(`@${task.planFile}`);
+  }
   return parts.join(" ");
 }
 function formatTasksCompact(tasks) {
@@ -253,6 +260,7 @@ This project uses \`ctt\` (Claude Task Tracker) for task management with depende
 - \`ctt add "title" -d "description"\` - Add task with detailed description
 - \`ctt add "title" -b <blocker-id>\` - Add task blocked by another
 - \`ctt add "title" -r <ref-id>\` - Add task with a reference to another
+- \`ctt add "title" -p <path>\` - Add task with a plan file reference
 - \`ctt list\` - List all tasks
 - \`ctt list -s <status>\` - List tasks by status (open, progress, completed)
 - \`ctt show <id>\` - Show task details
@@ -266,6 +274,7 @@ This project uses \`ctt\` (Claude Task Tracker) for task management with depende
 - \`ctt ref <id> --to <ref-id>\` - Add soft reference to another task
 - \`ctt unref <id> --to <ref-id>\` - Remove soft reference
 - \`ctt overview <id> "text"\` - Set or update task overview
+- \`ctt plan <id> <path>\` - Set or update plan file reference
 - \`ctt delete <id>\` - Delete a task
 - \`ctt cleanup\` - Remove completed tasks older than 7 days
 - \`ctt cleanup -d <days>\` - Remove completed tasks older than N days
@@ -279,6 +288,9 @@ ctt add "Implement user authentication" -d "Add JWT-based auth with login/logout
 
 # Add a task blocked by another with description
 ctt add "Add password reset" -d "Email-based password reset flow" -b t1
+
+# Add a task with a plan file containing detailed implementation notes
+ctt add "Refactor database layer" -p .tasks/plans/db-refactor.md
 \`\`\`
 
 ### Compact Format
@@ -286,6 +298,7 @@ ctt add "Add password reset" -d "Email-based password reset flow" -b t1
 - \`<t1,t2\` = blocked by tasks
 - \`~t1\` = references task
 - \`>text\` = overview
+- \`@path\` = plan file reference
 `;
 function setupClaudeMd(cwd = process.cwd()) {
   const claudeMdPath = join2(cwd, "CLAUDE.md");
@@ -318,7 +331,7 @@ program.command("init").description("Initialize task store and setup CLAUDE.md")
     process.exit(1);
   }
 });
-program.command("add <title>").description("Add a new task").option("-d, --description <desc>", "Task description").option("-b, --blocked-by <ids>", "Comma-separated IDs of blocking tasks").option("-r, --ref <ids>", "Comma-separated IDs of referenced tasks").action((title, options) => {
+program.command("add <title>").description("Add a new task").option("-d, --description <desc>", "Task description").option("-b, --blocked-by <ids>", "Comma-separated IDs of blocking tasks").option("-r, --ref <ids>", "Comma-separated IDs of referenced tasks").option("-p, --plan-file <path>", "Path to plan file with detailed planning notes").action((title, options) => {
   try {
     const store = loadStore();
     const blockedBy = options.blockedBy ? options.blockedBy.split(",").map((s) => s.trim()) : [];
@@ -332,7 +345,8 @@ program.command("add <title>").description("Add a new task").option("-d, --descr
     const task = addTask(store, title, {
       description: options.description,
       blockedBy,
-      references
+      references,
+      planFile: options.planFile
     });
     saveStore(store);
     const fmt = getOutputFormat();
@@ -625,6 +639,26 @@ program.command("overview <id> <text>").description("Set or update task overview
     process.exit(1);
   }
 });
+program.command("plan <id> <path>").description("Set or update plan file reference for a task").action((id, path) => {
+  try {
+    const store = loadStore();
+    const task = getTask(store, id);
+    if (!task) {
+      console.error(`Task ${id} not found.`);
+      process.exit(1);
+    }
+    updateTask(store, id, { planFile: path });
+    saveStore(store);
+    if (program.opts().json) {
+      console.log(formatTaskJson(getTask(store, id)));
+    } else {
+      console.log(`Updated plan file for ${id}: ${path}`);
+    }
+  } catch (err) {
+    console.error(err.message);
+    process.exit(1);
+  }
+});
 program.command("context <id>").description("Show task with all dependency overviews for quick context lookup").action((id) => {
   try {
     const store = loadStore();

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "claude-task-tracker",
-  "version": "1.0.10",
+  "version": "1.0.11",
   "description": "CLI task tracker with dependency management for agentic code workflows",
   "type": "module",
   "bin": {