mcp-adr-analysis-server 2.5.4 → 2.6.0

package/dist/src/resources/todo-list-resource.d.ts

@@ -12,6 +12,12 @@ export interface TodoTask {
     dependencies?: string[];
     createdAt?: string;
     updatedAt?: string;
+    adrId?: string;
+    linkedAdrs?: string[];
+    milestoneId?: string;
+    tddPhase?: 'test' | 'production';
+    effort?: string;
+    category?: string;
 }
 /**
  * Generate comprehensive todo list resource with task management and progress tracking.

package/dist/src/resources/todo-list-resource.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"todo-list-resource.d.ts","sourceRoot":"","sources":["../../../src/resources/todo-list-resource.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAMH,OAAO,EAAE,wBAAwB,EAAE,MAAM,YAAY,CAAC;AAEtD,MAAM,WAAW,QAAQ;IACvB,EAAE,EAAE,MAAM,CAAC;IACX,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,SAAS,GAAG,aAAa,GAAG,WAAW,CAAC;IAChD,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,QAAQ,CAAC,EAAE,KAAK,GAAG,QAAQ,GAAG,MAAM,GAAG,UAAU,CAAC;IAClD,YAAY,CAAC,EAAE,MAAM,EAAE,CAAC;IACxB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AA8ED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA8EG;AACH,wBAAsB,wBAAwB,IAAI,OAAO,CAAC,wBAAwB,CAAC,CA2DlF"}
+{"version":3,"file":"todo-list-resource.d.ts","sourceRoot":"","sources":["../../../src/resources/todo-list-resource.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAMH,OAAO,EAAE,wBAAwB,EAAE,MAAM,YAAY,CAAC;AAEtD,MAAM,WAAW,QAAQ;IACvB,EAAE,EAAE,MAAM,CAAC;IACX,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,SAAS,GAAG,aAAa,GAAG,WAAW,CAAC;IAChD,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,QAAQ,CAAC,EAAE,KAAK,GAAG,QAAQ,GAAG,MAAM,GAAG,UAAU,CAAC;IAClD,YAAY,CAAC,EAAE,MAAM,EAAE,CAAC;IACxB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,UAAU,CAAC,EAAE,MAAM,EAAE,CAAC;IACtB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,QAAQ,CAAC,EAAE,MAAM,GAAG,YAAY,CAAC;IACjC,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB;AAkID;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA8EG;AACH,wBAAsB,wBAAwB,IAAI,OAAO,CAAC,wBAAwB,CAAC,CA2DlF"}

package/dist/src/resources/todo-list-resource.js

@@ -14,6 +14,46 @@ function parseTodoMarkdown(content) {
     const lines = content.split('\n');
     let currentTask = null;
     let taskCounter = 0;
+    const pinPatterns = [
+        [
+            /<!--\s*adr:\s*([^\s>]+)\s*-->/i,
+            (m, t) => {
+                if (m[1])
+                    t.adrId = m[1];
+            },
+        ],
+        [
+            /<!--\s*linked-adrs:\s*([^>]+?)\s*-->/i,
+            (m, t) => {
+                if (m[1])
+                    t.linkedAdrs = m[1]
+                        .split(',')
+                        .map(s => s.trim())
+                        .filter(Boolean);
+            },
+        ],
+        [
+            /<!--\s*milestone:\s*([^\s>]+)\s*-->/i,
+            (m, t) => {
+                if (m[1])
+                    t.milestoneId = m[1];
+            },
+        ],
+        [
+            /<!--\s*tdd:\s*(test|production)\s*-->/i,
+            (m, t) => {
+                if (m[1])
+                    t.tddPhase = m[1].toLowerCase();
+            },
+        ],
+        [
+            /<!--\s*task-id:\s*([^\s>]+)\s*-->/i,
+            (m, t) => {
+                if (m[1])
+                    t.id = m[1];
+            },
+        ],
+    ];
     for (const line of lines) {
         const trimmed = line.trim();
         // Parse task line: ## Task Title
@@ -30,6 +70,20 @@ function parseTodoMarkdown(content) {
             };
             continue;
         }
+        // Parse inline pin comments
+        if (currentTask) {
+            let pinMatched = false;
+            for (const [pattern, apply] of pinPatterns) {
+                const m = trimmed.match(pattern);
+                if (m) {
+                    apply(m, currentTask);
+                    pinMatched = true;
+                    break;
+                }
+            }
+            if (pinMatched)
+                continue;
+        }
         // Parse status
         if (trimmed.startsWith('**Status:**') && currentTask) {
             const status = trimmed.substring(11).trim().toLowerCase();
@@ -65,6 +119,7 @@ function parseTodoMarkdown(content) {
         if (currentTask &&
             !trimmed.startsWith('**') &&
             !trimmed.startsWith('#') &&
+            !trimmed.startsWith('<!--') &&
             trimmed.length > 0) {
             currentTask.description = (currentTask.description || '') + '\n' + trimmed;
         }

package/dist/src/resources/todo-list-resource.js.map

@@ -1 +1 @@
-{"version":3,"file":"todo-list-resource.js","sourceRoot":"","sources":["../../../src/resources/todo-list-resource.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,KAAK,EAAE,MAAM,aAAa,CAAC;AAClC,OAAO,KAAK,IAAI,MAAM,MAAM,CAAC;AAC7B,OAAO,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAChD,OAAO,EAAE,aAAa,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAC;AAclE;;GAEG;AACH,SAAS,iBAAiB,CAAC,OAAe;IACxC,MAAM,KAAK,GAAe,EAAE,CAAC;IAC7B,MAAM,KAAK,GAAG,OAAO,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;IAElC,IAAI,WAAW,GAA6B,IAAI,CAAC;IACjD,IAAI,WAAW,GAAG,CAAC,CAAC;IAEpB,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;QACzB,MAAM,OAAO,GAAG,IAAI,CAAC,IAAI,EAAE,CAAC;QAE5B,iCAAiC;QACjC,IAAI,OAAO,CAAC,UAAU,CAAC,KAAK,CAAC,EAAE,CAAC;YAC9B,IAAI,WAAW,EAAE,CAAC;gBAChB,KAAK,CAAC,IAAI,CAAC,WAAuB,CAAC,CAAC;YACtC,CAAC;YAED,MAAM,KAAK,GAAG,OAAO,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC;YAC1C,WAAW,EAAE,CAAC;YACd,WAAW,GAAG;gBACZ,EAAE,EAAE,QAAQ,WAAW,EAAE;gBACzB,KAAK;gBACL,MAAM,EAAE,SAAS;aAClB,CAAC;YACF,SAAS;QACX,CAAC;QAED,eAAe;QACf,IAAI,OAAO,CAAC,UAAU,CAAC,aAAa,CAAC,IAAI,WAAW,EAAE,CAAC;YACrD,MAAM,MAAM,GAAG,OAAO,CAAC,SAAS,CAAC,EAAE,CAAC,CAAC,IAAI,EAAE,CAAC,WAAW,EAAE,CAAC;YAC1D,IAAI,MAAM,CAAC,QAAQ,CAAC,UAAU,CAAC,EAAE,CAAC;gBAChC,WAAW,CAAC,MAAM,GAAG,aAAa,CAAC;YACrC,CAAC;iBAAM,IAAI,MAAM,CAAC,QAAQ,CAAC,WAAW,CAAC,EAAE,CAAC;gBACxC,WAAW,CAAC,MAAM,GAAG,WAAW,CAAC;YACnC,CAAC;iBAAM,CAAC;gBACN,WAAW,CAAC,MAAM,GAAG,SAAS,CAAC;YACjC,CAAC;YACD,SAAS;QACX,CAAC;QAED,iBAAiB;QACjB,IAAI,OAAO,CAAC,UAAU,CAAC,eAAe,CAAC,IAAI,WAAW,EAAE,CAAC;YACvD,MAAM,QAAQ,GAAG,OAAO,CAAC,SAAS,CAAC,EAAE,CAAC,CAAC,IAAI,EAAE,CAAC,WAAW,EAAE,CAAC;YAC5D,IAAI,QAAQ,CAAC,QAAQ,CAAC,UAAU,CAAC,EAAE,CAAC;gBAClC,WAAW,CAAC,QAAQ,GAAG,UAAU,CAAC;YACpC,CAAC;iBAAM,IAAI,QAAQ,CAAC,QAAQ,CAAC,MAAM,CAAC,EAAE,CAAC;gBACrC,WAAW,CAAC,QAAQ,GAAG,MAAM,CAAC;YAChC,CAAC;iBAAM,IAAI,QAAQ,CAAC,QAAQ,CAAC,KAAK,CAAC,EAAE,CAAC;gBACpC,WAAW,CAAC,QAAQ,GAAG,KAAK,CAAC;YAC/B,CAAC;iBAAM,CAAC;gBACN,WAAW,CAAC,QAAQ,GAAG,QAAQ,CAAC;YAClC,CAAC;YACD,SAAS;QACX,CAAC;QAED,uCAAuC;QACvC,IACE,WAAW;YACX,CAAC,OAAO,CAAC,UAAU,CAAC,IAAI,CAAC;YACzB,CAAC,OAAO,CAAC,UAAU,CAAC,GAAG,CAAC;YACxB,OAAO,CAAC,MAAM,GAAG,CAAC,EAClB,CAAC;YACD,WAAW,CAAC,WAAW,GAAG,CAAC,WAAW,CAAC,WAAW,IAAI,EAAE,CAAC,GAAG,IAAI,GAAG,OAAO,CAAC;QAC7E,CAAC;IACH,CAAC;IAED,gBAAgB;IAChB,IAAI,WAAW,EAAE,CAAC;QAChB,KAAK,CAAC,IAAI,CAAC,WAAuB,CAAC,CAAC;IACtC,CAAC;IAED,OAAO,KAAK,CAAC;AACf,CAAC;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA8EG;AACH,MAAM,CAAC,KAAK,UAAU,wBAAwB;IAC5C,IAAI,CAAC;QACH,MAAM,QAAQ,GAAG,mBAAmB,CAAC;QAErC,cAAc;QACd,MAAM,MAAM,GAAG,MAAM,aAAa,CAAC,GAAG,CAA2B,QAAQ,CAAC,CAAC;QAC3E,IAAI,MAAM,EAAE,CAAC;YACX,OAAO,MAAM,CAAC;QAChB,CAAC;QAED,MAAM,QAAQ,GAAG,IAAI,CAAC,OAAO,CAAC,OAAO,CAAC,GAAG,EAAE,EAAE,SAAS,CAAC,CAAC;QACxD,IAAI,KAAK,GAAe,EAAE,CAAC;QAE3B,IAAI,CAAC;YACH,MAAM,WAAW,GAAG,MAAM,EAAE,CAAC,QAAQ,CAAC,QAAQ,EAAE,OAAO,CAAC,CAAC;YACzD,KAAK,GAAG,iBAAiB,CAAC,WAAW,CAAC,CAAC;QACzC,CAAC;QAAC,MAAM,CAAC;YACP,6CAA6C;YAC7C,OAAO,CAAC,IAAI,CAAC,6CAA6C,QAAQ,EAAE,CAAC,CAAC;QACxE,CAAC;QAED,MAAM,YAAY,GAAG;YACnB,OAAO,EAAE,OAAO;YAChB,SAAS,EAAE,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE;YACnC,MAAM,EAAE,QAAQ;YAChB,OAAO,EAAE;gBACP,KAAK,EAAE,KAAK,CAAC,MAAM;gBACnB,OAAO,EAAE,KAAK,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,MAAM,KAAK,SAAS,CAAC,CAAC,MAAM;gBACzD,UAAU,EAAE,KAAK,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,MAAM,KAAK,aAAa,CAAC,CAAC,MAAM;gBAChE,SAAS,EAAE,KAAK,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,MAAM,KAAK,WAAW,CAAC,CAAC,MAAM;gBAC7D,UAAU,EAAE;oBACV,QAAQ,EAAE,KAAK,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,QAAQ,KAAK,UAAU,CAAC,CAAC,MAAM;oBAC7D,IAAI,EAAE,KAAK,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,QAAQ,KAAK,MAAM,CAAC,CAAC,MAAM;oBACrD,MAAM,EAAE,KAAK,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,QAAQ,KAAK,QAAQ,CAAC,CAAC,MAAM;oBACzD,GAAG,EAAE,KAAK,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,QAAQ,KAAK,KAAK,CAAC,CAAC,MAAM;iBACpD;aACF;YACD,KAAK;SACN,CAAC;QAEF,MAAM,MAAM,GAA6B;YACvC,IAAI,EAAE,YAAY;YAClB,WAAW,EAAE,kBAAkB;YAC/B,YAAY,EAAE,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE;YACtC,QAAQ;YACR,GAAG,EAAE,EAAE,EAAE,2CAA2C;YACpD,IAAI,EAAE,YAAY,CAAC,YAAY,CAAC;SACjC,CAAC;QAEF,eAAe;QACf,aAAa,CAAC,GAAG,CAAC,QAAQ,EAAE,MAAM,EAAE,MAAM,CAAC,GAAG,CAAC,CAAC;QAEhD,OAAO,MAAM,CAAC;IAChB,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,MAAM,IAAI,WAAW,CACnB,0CAA0C,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,EAAE,EAClG,2BAA2B,CAC5B,CAAC;IACJ,CAAC;AACH,CAAC"}
+{"version":3,"file":"todo-list-resource.js","sourceRoot":"","sources":["../../../src/resources/todo-list-resource.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,KAAK,EAAE,MAAM,aAAa,CAAC;AAClC,OAAO,KAAK,IAAI,MAAM,MAAM,CAAC;AAC7B,OAAO,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAChD,OAAO,EAAE,aAAa,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAC;AAoBlE;;GAEG;AACH,SAAS,iBAAiB,CAAC,OAAe;IACxC,MAAM,KAAK,GAAe,EAAE,CAAC;IAC7B,MAAM,KAAK,GAAG,OAAO,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;IAElC,IAAI,WAAW,GAA6B,IAAI,CAAC;IACjD,IAAI,WAAW,GAAG,CAAC,CAAC;IAEpB,MAAM,WAAW,GAAyE;QACxF;YACE,gCAAgC;YAChC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE;gBACP,IAAI,CAAC,CAAC,CAAC,CAAC;oBAAE,CAAC,CAAC,KAAK,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC;YAC3B,CAAC;SACF;QACD;YACE,uCAAuC;YACvC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE;gBACP,IAAI,CAAC,CAAC,CAAC,CAAC;oBACN,CAAC,CAAC,UAAU,GAAG,CAAC,CAAC,CAAC,CAAC;yBAChB,KAAK,CAAC,GAAG,CAAC;yBACV,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC;yBAClB,MAAM,CAAC,OAAO,CAAC,CAAC;YACvB,CAAC;SACF;QACD;YACE,sCAAsC;YACtC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE;gBACP,IAAI,CAAC,CAAC,CAAC,CAAC;oBAAE,CAAC,CAAC,WAAW,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC;YACjC,CAAC;SACF;QACD;YACE,wCAAwC;YACxC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE;gBACP,IAAI,CAAC,CAAC,CAAC,CAAC;oBAAE,CAAC,CAAC,QAAQ,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,WAAW,EAA2B,CAAC;YACrE,CAAC;SACF;QACD;YACE,oCAAoC;YACpC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE;gBACP,IAAI,CAAC,CAAC,CAAC,CAAC;oBAAE,CAAC,CAAC,EAAE,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC;YACxB,CAAC;SACF;KACF,CAAC;IAEF,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;QACzB,MAAM,OAAO,GAAG,IAAI,CAAC,IAAI,EAAE,CAAC;QAE5B,iCAAiC;QACjC,IAAI,OAAO,CAAC,UAAU,CAAC,KAAK,CAAC,EAAE,CAAC;YAC9B,IAAI,WAAW,EAAE,CAAC;gBAChB,KAAK,CAAC,IAAI,CAAC,WAAuB,CAAC,CAAC;YACtC,CAAC;YAED,MAAM,KAAK,GAAG,OAAO,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC;YAC1C,WAAW,EAAE,CAAC;YACd,WAAW,GAAG;gBACZ,EAAE,EAAE,QAAQ,WAAW,EAAE;gBACzB,KAAK;gBACL,MAAM,EAAE,SAAS;aAClB,CAAC;YACF,SAAS;QACX,CAAC;QAED,4BAA4B;QAC5B,IAAI,WAAW,EAAE,CAAC;YAChB,IAAI,UAAU,GAAG,KAAK,CAAC;YACvB,KAAK,MAAM,CAAC,OAAO,EAAE,KAAK,CAAC,IAAI,WAAW,EAAE,CAAC;gBAC3C,MAAM,CAAC,GAAG,OAAO,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC;gBACjC,IAAI,CAAC,EAAE,CAAC;oBACN,KAAK,CAAC,CAAC,EAAE,WAAW,CAAC,CAAC;oBACtB,UAAU,GAAG,IAAI,CAAC;oBAClB,MAAM;gBACR,CAAC;YACH,CAAC;YACD,IAAI,UAAU;gBAAE,SAAS;QAC3B,CAAC;QAED,eAAe;QACf,IAAI,OAAO,CAAC,UAAU,CAAC,aAAa,CAAC,IAAI,WAAW,EAAE,CAAC;YACrD,MAAM,MAAM,GAAG,OAAO,CAAC,SAAS,CAAC,EAAE,CAAC,CAAC,IAAI,EAAE,CAAC,WAAW,EAAE,CAAC;YAC1D,IAAI,MAAM,CAAC,QAAQ,CAAC,UAAU,CAAC,EAAE,CAAC;gBAChC,WAAW,CAAC,MAAM,GAAG,aAAa,CAAC;YACrC,CAAC;iBAAM,IAAI,MAAM,CAAC,QAAQ,CAAC,WAAW,CAAC,EAAE,CAAC;gBACxC,WAAW,CAAC,MAAM,GAAG,WAAW,CAAC;YACnC,CAAC;iBAAM,CAAC;gBACN,WAAW,CAAC,MAAM,GAAG,SAAS,CAAC;YACjC,CAAC;YACD,SAAS;QACX,CAAC;QAED,iBAAiB;QACjB,IAAI,OAAO,CAAC,UAAU,CAAC,eAAe,CAAC,IAAI,WAAW,EAAE,CAAC;YACvD,MAAM,QAAQ,GAAG,OAAO,CAAC,SAAS,CAAC,EAAE,CAAC,CAAC,IAAI,EAAE,CAAC,WAAW,EAAE,CAAC;YAC5D,IAAI,QAAQ,CAAC,QAAQ,CAAC,UAAU,CAAC,EAAE,CAAC;gBAClC,WAAW,CAAC,QAAQ,GAAG,UAAU,CAAC;YACpC,CAAC;iBAAM,IAAI,QAAQ,CAAC,QAAQ,CAAC,MAAM,CAAC,EAAE,CAAC;gBACrC,WAAW,CAAC,QAAQ,GAAG,MAAM,CAAC;YAChC,CAAC;iBAAM,IAAI,QAAQ,CAAC,QAAQ,CAAC,KAAK,CAAC,EAAE,CAAC;gBACpC,WAAW,CAAC,QAAQ,GAAG,KAAK,CAAC;YAC/B,CAAC;iBAAM,CAAC;gBACN,WAAW,CAAC,QAAQ,GAAG,QAAQ,CAAC;YAClC,CAAC;YACD,SAAS;QACX,CAAC;QAED,uCAAuC;QACvC,IACE,WAAW;YACX,CAAC,OAAO,CAAC,UAAU,CAAC,IAAI,CAAC;YACzB,CAAC,OAAO,CAAC,UAAU,CAAC,GAAG,CAAC;YACxB,CAAC,OAAO,CAAC,UAAU,CAAC,MAAM,CAAC;YAC3B,OAAO,CAAC,MAAM,GAAG,CAAC,EAClB,CAAC;YACD,WAAW,CAAC,WAAW,GAAG,CAAC,WAAW,CAAC,WAAW,IAAI,EAAE,CAAC,GAAG,IAAI,GAAG,OAAO,CAAC;QAC7E,CAAC;IACH,CAAC;IAED,gBAAgB;IAChB,IAAI,WAAW,EAAE,CAAC;QAChB,KAAK,CAAC,IAAI,CAAC,WAAuB,CAAC,CAAC;IACtC,CAAC;IAED,OAAO,KAAK,CAAC;AACf,CAAC;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA8EG;AACH,MAAM,CAAC,KAAK,UAAU,wBAAwB;IAC5C,IAAI,CAAC;QACH,MAAM,QAAQ,GAAG,mBAAmB,CAAC;QAErC,cAAc;QACd,MAAM,MAAM,GAAG,MAAM,aAAa,CAAC,GAAG,CAA2B,QAAQ,CAAC,CAAC;QAC3E,IAAI,MAAM,EAAE,CAAC;YACX,OAAO,MAAM,CAAC;QAChB,CAAC;QAED,MAAM,QAAQ,GAAG,IAAI,CAAC,OAAO,CAAC,OAAO,CAAC,GAAG,EAAE,EAAE,SAAS,CAAC,CAAC;QACxD,IAAI,KAAK,GAAe,EAAE,CAAC;QAE3B,IAAI,CAAC;YACH,MAAM,WAAW,GAAG,MAAM,EAAE,CAAC,QAAQ,CAAC,QAAQ,EAAE,OAAO,CAAC,CAAC;YACzD,KAAK,GAAG,iBAAiB,CAAC,WAAW,CAAC,CAAC;QACzC,CAAC;QAAC,MAAM,CAAC;YACP,6CAA6C;YAC7C,OAAO,CAAC,IAAI,CAAC,6CAA6C,QAAQ,EAAE,CAAC,CAAC;QACxE,CAAC;QAED,MAAM,YAAY,GAAG;YACnB,OAAO,EAAE,OAAO;YAChB,SAAS,EAAE,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE;YACnC,MAAM,EAAE,QAAQ;YAChB,OAAO,EAAE;gBACP,KAAK,EAAE,KAAK,CAAC,MAAM;gBACnB,OAAO,EAAE,KAAK,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,MAAM,KAAK,SAAS,CAAC,CAAC,MAAM;gBACzD,UAAU,EAAE,KAAK,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,MAAM,KAAK,aAAa,CAAC,CAAC,MAAM;gBAChE,SAAS,EAAE,KAAK,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,MAAM,KAAK,WAAW,CAAC,CAAC,MAAM;gBAC7D,UAAU,EAAE;oBACV,QAAQ,EAAE,KAAK,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,QAAQ,KAAK,UAAU,CAAC,CAAC,MAAM;oBAC7D,IAAI,EAAE,KAAK,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,QAAQ,KAAK,MAAM,CAAC,CAAC,MAAM;oBACrD,MAAM,EAAE,KAAK,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,QAAQ,KAAK,QAAQ,CAAC,CAAC,MAAM;oBACzD,GAAG,EAAE,KAAK,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,QAAQ,KAAK,KAAK,CAAC,CAAC,MAAM;iBACpD;aACF;YACD,KAAK;SACN,CAAC;QAEF,MAAM,MAAM,GAA6B;YACvC,IAAI,EAAE,YAAY;YAClB,WAAW,EAAE,kBAAkB;YAC/B,YAAY,EAAE,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE;YACtC,QAAQ;YACR,GAAG,EAAE,EAAE,EAAE,2CAA2C;YACpD,IAAI,EAAE,YAAY,CAAC,YAAY,CAAC;SACjC,CAAC;QAEF,eAAe;QACf,aAAa,CAAC,GAAG,CAAC,QAAQ,EAAE,MAAM,EAAE,MAAM,CAAC,GAAG,CAAC,CAAC;QAEhD,OAAO,MAAM,CAAC;IAChB,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,MAAM,IAAI,WAAW,CACnB,0CAA0C,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,EAAE,EAClG,2BAA2B,CAC5B,CAAC;IACJ,CAAC;AACH,CAAC"}

package/dist/src/tools/generate-adr-todo-tool.d.ts

@@ -0,0 +1,34 @@
+/**
+ * generate_adr_todo MCP Tool
+ *
+ * Decomposes ADRs into TODO entries with stable IDs, idempotent merging, and
+ * optional milestone linking. Mirrors the bounded-section persistence pattern
+ * proven in `release-tracker.ts:580-596` so manual edits to TODO.md outside the
+ * managed block are preserved verbatim.
+ *
+ * Re-runs are safe: tasks key off `adrId + slug(title) + tddPhase`, user-set
+ * status survives, and tasks whose source ADR is deleted/superseded are moved
+ * to a "Stale Tasks" subsection rather than silently dropped.
+ */
+import { z } from 'zod';
+declare const GenerateAdrTodoSchema: z.ZodObject<{
+    adrDirectory: z.ZodDefault<z.ZodString>;
+    scope: z.ZodDefault<z.ZodEnum<{
+        pending: "pending";
+        accepted: "accepted";
+        all: "all";
+    }>>;
+    projectPath: z.ZodOptional<z.ZodString>;
+    todoPath: z.ZodDefault<z.ZodString>;
+    phase: z.ZodDefault<z.ZodEnum<{
+        test: "test";
+        production: "production";
+        both: "both";
+    }>>;
+    linkToMilestones: z.ZodDefault<z.ZodBoolean>;
+    dryRun: z.ZodDefault<z.ZodBoolean>;
+}, z.core.$strip>;
+export type GenerateAdrTodoArgs = z.infer<typeof GenerateAdrTodoSchema>;
+export declare function generateAdrTodo(args: Record<string, unknown>): Promise<any>;
+export {};
+//# sourceMappingURL=generate-adr-todo-tool.d.ts.map

package/dist/src/tools/generate-adr-todo-tool.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"generate-adr-todo-tool.d.ts","sourceRoot":"","sources":["../../../src/tools/generate-adr-todo-tool.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAIH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAiBxB,QAAA,MAAM,qBAAqB;;;;;;;;;;;;;;;;iBAmBzB,CAAC;AAEH,MAAM,MAAM,mBAAmB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,qBAAqB,CAAC,CAAC;AAoIxE,wBAAsB,eAAe,CAAC,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,OAAO,CAAC,GAAG,CAAC,CAyIjF"}

package/dist/src/tools/generate-adr-todo-tool.js

@@ -0,0 +1,292 @@
+/**
+ * generate_adr_todo MCP Tool
+ *
+ * Decomposes ADRs into TODO entries with stable IDs, idempotent merging, and
+ * optional milestone linking. Mirrors the bounded-section persistence pattern
+ * proven in `release-tracker.ts:580-596` so manual edits to TODO.md outside the
+ * managed block are preserved verbatim.
+ *
+ * Re-runs are safe: tasks key off `adrId + slug(title) + tddPhase`, user-set
+ * status survives, and tasks whose source ADR is deleted/superseded are moved
+ * to a "Stale Tasks" subsection rather than silently dropped.
+ */
+import { existsSync, readFileSync, writeFileSync } from 'fs';
+import { resolve } from 'path';
+import { z } from 'zod';
+import { McpAdrError } from '../types/index.js';
+import { jsonSafeError } from '../utils/json-safe.js';
+import { validateMcpResponse } from '../utils/mcp-response-validator.js';
+import { discoverAdrsInDirectory } from '../utils/adr-discovery.js';
+import { decomposeAdrToTasks, linkTasksToMilestones, mergeTodoTasks, renderTodoSection, spliceTodoSection, } from '../utils/adr-todo-generator.js';
+import { listLocal } from '../utils/local-milestone-store.js';
+import { buildMilestoneMap } from '../utils/release-tracker.js';
+const GenerateAdrTodoSchema = z.object({
+    adrDirectory: z.string().default('docs/adrs').describe('Directory containing ADR files'),
+    scope: z
+        .enum(['all', 'pending', 'accepted'])
+        .default('pending')
+        .describe('Which ADRs to decompose: all, pending (proposed/draft), or accepted only'),
+    projectPath: z.string().optional().describe('Project root path (defaults to process.cwd())'),
+    todoPath: z.string().default('TODO.md').describe('Output TODO file (relative to projectPath)'),
+    phase: z
+        .enum(['both', 'test', 'production'])
+        .default('both')
+        .describe('TDD pairing: "both" emits paired test+production tasks (default), "production" or "test" narrows output'),
+    linkToMilestones: z
+        .boolean()
+        .default(true)
+        .describe('Link generated tasks to release milestones (local + GitHub merged)'),
+    dryRun: z.boolean().default(false).describe('Compute changes but do not write TODO.md'),
+});
+function inScope(status, scope) {
+    if (scope === 'all')
+        return true;
+    const s = (status || '').toLowerCase();
+    if (scope === 'accepted')
+        return s === 'accepted';
+    // 'pending' covers anything that isn't accepted/superseded/deprecated/rejected
+    return !['accepted', 'superseded', 'deprecated', 'rejected'].includes(s);
+}
+function isSuperseded(status) {
+    const s = (status || '').toLowerCase();
+    return s === 'superseded' || s === 'deprecated' || s === 'rejected';
+}
+function parseExistingTasks(content) {
+    // Lightweight parser scoped to the bounded section. We can't import the
+    // private `parseTodoMarkdown` from `todo-list-resource.ts`, so we replicate
+    // its behavior over the entire content (cheap; TODO.md is tiny in practice).
+    const tasks = [];
+    const lines = content.split('\n');
+    let current = null;
+    let counter = 0;
+    const pinPatterns = [
+        [
+            /<!--\s*adr:\s*([^\s>]+)\s*-->/i,
+            (m, t) => {
+                if (m[1])
+                    t.adrId = m[1];
+            },
+        ],
+        [
+            /<!--\s*linked-adrs:\s*([^>]+?)\s*-->/i,
+            (m, t) => {
+                if (m[1])
+                    t.linkedAdrs = m[1]
+                        .split(',')
+                        .map(s => s.trim())
+                        .filter(Boolean);
+            },
+        ],
+        [
+            /<!--\s*milestone:\s*([^\s>]+)\s*-->/i,
+            (m, t) => {
+                if (m[1])
+                    t.milestoneId = m[1];
+            },
+        ],
+        [
+            /<!--\s*tdd:\s*(test|production)\s*-->/i,
+            (m, t) => {
+                if (m[1])
+                    t.tddPhase = m[1].toLowerCase();
+            },
+        ],
+        [
+            /<!--\s*task-id:\s*([^\s>]+)\s*-->/i,
+            (m, t) => {
+                if (m[1])
+                    t.id = m[1];
+            },
+        ],
+    ];
+    for (const line of lines) {
+        const trimmed = line.trim();
+        if (trimmed.startsWith('## ')) {
+            if (current)
+                tasks.push(current);
+            counter++;
+            current = {
+                id: `task-${counter}`,
+                title: trimmed.substring(3).trim(),
+                status: 'pending',
+            };
+            continue;
+        }
+        if (current) {
+            let pinned = false;
+            for (const [pat, apply] of pinPatterns) {
+                const m = trimmed.match(pat);
+                if (m) {
+                    apply(m, current);
+                    pinned = true;
+                    break;
+                }
+            }
+            if (pinned)
+                continue;
+            if (trimmed.startsWith('**Status:**')) {
+                const status = trimmed.substring(11).trim().toLowerCase();
+                current.status = status.includes('progress')
+                    ? 'in_progress'
+                    : status.includes('completed')
+                        ? 'completed'
+                        : 'pending';
+                continue;
+            }
+            if (trimmed.startsWith('**Priority:**')) {
+                const p = trimmed.substring(13).trim().toLowerCase();
+                current.priority = p.includes('critical')
+                    ? 'critical'
+                    : p.includes('high')
+                        ? 'high'
+                        : p.includes('low')
+                            ? 'low'
+                            : 'medium';
+                continue;
+            }
+            if (trimmed.startsWith('**Effort:**')) {
+                current.effort = trimmed.substring(11).trim();
+                continue;
+            }
+            if (trimmed.startsWith('**Category:**')) {
+                current.category = trimmed.substring(13).trim();
+                continue;
+            }
+            if (!trimmed.startsWith('**') &&
+                !trimmed.startsWith('#') &&
+                !trimmed.startsWith('<!--') &&
+                trimmed.length > 0) {
+                current.description =
+                    (current.description || '') + (current.description ? '\n' : '') + trimmed;
+            }
+        }
+    }
+    if (current)
+        tasks.push(current);
+    return tasks;
+}
+export async function generateAdrTodo(args) {
+    try {
+        const validated = GenerateAdrTodoSchema.parse(args);
+        const projectPath = validated.projectPath ?? process.cwd();
+        const discovery = await discoverAdrsInDirectory(validated.adrDirectory, projectPath, {
+            includeContent: true,
+            includeTimeline: false,
+        });
+        const allAdrs = discovery.adrs;
+        const filteredAdrs = allAdrs.filter(a => inScope(a.status, validated.scope));
+        const activeAdrIds = new Set(allAdrs.filter(a => !isSuperseded(a.status)).map(a => a.filename));
+        const supersededAdrIds = new Set(allAdrs.filter(a => isSuperseded(a.status)).map(a => a.filename));
+        const generatedAt = new Date().toISOString();
+        const generated = [];
+        for (const adr of filteredAdrs) {
+            generated.push(...decomposeAdrToTasks(adr, { phase: validated.phase, generatedAt }));
+        }
+        const milestones = validated.linkToMilestones
+            ? await buildMilestoneMap(allAdrs, projectPath).catch(() => [])
+            : [];
+        if (validated.linkToMilestones) {
+            try {
+                const local = listLocal(projectPath);
+                const seen = new Set(milestones.map(m => (m.id || m.name).toLowerCase()));
+                for (const lm of local) {
+                    const key = (lm.id || lm.name).toLowerCase();
+                    if (!seen.has(key)) {
+                        milestones.push(lm);
+                        seen.add(key);
+                    }
+                }
+            }
+            catch {
+                // local store missing or unreadable — non-fatal
+            }
+        }
+        let linkedTasks = generated;
+        let linkedMilestones = milestones;
+        if (validated.linkToMilestones && milestones.length > 0) {
+            const linked = linkTasksToMilestones(generated, milestones, allAdrs);
+            linkedTasks = linked.tasks;
+            linkedMilestones = linked.milestones;
+        }
+        const todoFullPath = resolve(projectPath, validated.todoPath);
+        const existingContent = existsSync(todoFullPath) ? readFileSync(todoFullPath, 'utf8') : '';
+        const existingTasks = existingContent ? parseExistingTasks(existingContent) : [];
+        const mergeResult = mergeTodoTasks(existingTasks, linkedTasks, {
+            activeAdrIds,
+            supersededAdrIds,
+        });
+        // Only ADR-derived tasks belong inside the managed section. Manual tasks
+        // (no adrId) get rendered as part of the user's hand-edited content
+        // outside the bounded block, so we don't include them in the section.
+        const managedTasks = mergeResult.merged.filter(t => !!t.adrId);
+        const section = renderTodoSection(managedTasks, mergeResult.stale, {
+            milestones: linkedMilestones,
+            generatedAt,
+        });
+        const newContent = spliceTodoSection(existingContent, section);
+        let wrote = false;
+        if (!validated.dryRun && newContent !== existingContent) {
+            writeFileSync(todoFullPath, newContent, 'utf8');
+            wrote = true;
+        }
+        const summaryLines = [
+            `# Generate ADR TODO`,
+            ``,
+            `**ADR directory:** \`${validated.adrDirectory}\``,
+            `**Scope:** ${validated.scope}`,
+            `**Phase:** ${validated.phase}`,
+            `**TODO file:** \`${validated.todoPath}\` ${wrote ? '(updated)' : validated.dryRun ? '(dry run — not written)' : '(unchanged)'}`,
+            ``,
+            `## Summary`,
+            ``,
+            `- ADRs discovered: ${allAdrs.length}`,
+            `- ADRs in scope: ${filteredAdrs.length}`,
+            `- Tasks generated: ${linkedTasks.length}`,
+            `- Tasks added: ${mergeResult.added}`,
+            `- Tasks preserved: ${mergeResult.preserved}`,
+            `- Stale tasks (moved to "Stale Tasks"): ${mergeResult.stale.length}`,
+            `- Milestones linked: ${linkedMilestones.length}`,
+            ``,
+        ];
+        if (mergeResult.stale.length > 0) {
+            summaryLines.push(`## Stale Tasks`, ``);
+            for (const t of mergeResult.stale.slice(0, 20)) {
+                summaryLines.push(`- \`${t.id}\` — ${t.title}${t.adrId ? ` _(orphaned: ${t.adrId})_` : ''}`);
+            }
+            if (mergeResult.stale.length > 20) {
+                summaryLines.push(`- … and ${mergeResult.stale.length - 20} more`);
+            }
+            summaryLines.push(``);
+        }
+        if (validated.dryRun) {
+            summaryLines.push(`## Dry-Run Diff Preview`, ``, '```diff', ...buildSimpleDiff(existingContent, newContent).slice(0, 200), '```', ``);
+        }
+        if (filteredAdrs.length === 0) {
+            summaryLines.push(`## No ADRs in scope`, ``, `Add ADR markdown files under \`${validated.adrDirectory}\` (or widen \`scope\`) and re-run.`);
+        }
+        return validateMcpResponse({
+            content: [{ type: 'text', text: summaryLines.join('\n') }],
+        });
+    }
+    catch (error) {
+        throw new McpAdrError(`generate_adr_todo failed: ${jsonSafeError(error)}`, 'GENERATE_ADR_TODO_ERROR');
+    }
+}
+function buildSimpleDiff(before, after) {
+    const beforeLines = before.split('\n');
+    const afterLines = after.split('\n');
+    const out = [];
+    const max = Math.max(beforeLines.length, afterLines.length);
+    for (let i = 0; i < max; i++) {
+        const a = beforeLines[i];
+        const b = afterLines[i];
+        if (a === b)
+            continue;
+        if (a !== undefined)
+            out.push(`- ${a}`);
+        if (b !== undefined)
+            out.push(`+ ${b}`);
+    }
+    return out;
+}
+//# sourceMappingURL=generate-adr-todo-tool.js.map

package/dist/src/tools/generate-adr-todo-tool.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"generate-adr-todo-tool.js","sourceRoot":"","sources":["../../../src/tools/generate-adr-todo-tool.ts"],"names":[],"mappings":"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"}

package/dist/src/tools/release-tracking-tool.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"release-tracking-tool.d.ts","sourceRoot":"","sources":["../../../src/tools/release-tracking-tool.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;GAgBG;AAiFH,wBAAsB,eAAe,CAAC,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,OAAO,CAAC,GAAG,CAAC,CAgDjF"}
+{"version":3,"file":"release-tracking-tool.d.ts","sourceRoot":"","sources":["../../../src/tools/release-tracking-tool.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;GAgBG;AAwGH,wBAAsB,eAAe,CAAC,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,OAAO,CAAC,GAAG,CAAC,CAmDjF"}

package/dist/src/tools/release-tracking-tool.js

@@ -20,6 +20,7 @@ import { McpAdrError } from '../types/index.js';
 import { validateMcpResponse } from '../utils/mcp-response-validator.js';
 import { jsonSafeError } from '../utils/json-safe.js';
 import { detectReleases, detectProjectType, mapAdrsToReleases, generateChangelog, writeChangelog, compareReleases, buildMilestoneMap, createGitHubRelease, syncGitHubMilestone, updateTodoMilestones, previewNextRelease, saveTrackingState, } from '../utils/release-tracker.js';
+import { listLocal, markPushed, slugify, upsertLocal, writeReleasePlanFile, } from '../utils/local-milestone-store.js';
 // ─── Schema ────────────────────────────────────────────────────────
 const ReleaseTrackingSchema = z.object({
     operation: z
@@ -32,6 +33,7 @@ const ReleaseTrackingSchema = z.object({
         'next_release_preview',
         'create_milestone',
         'sync_milestones',
+        'push_local_milestones',
     ])
         .describe('Operation to perform'),
     projectPath: z.string().optional().describe('Project root path'),
@@ -66,6 +68,18 @@ const ReleaseTrackingSchema = z.object({
         .default(false)
         .describe('Sync milestones to GitHub (requires gh CLI)'),
     updateTodo: z.boolean().default(false).describe('Update TODO.md with milestone status'),
+    localOnly: z
+        .boolean()
+        .default(false)
+        .describe('For create_milestone: persist locally instead of calling gh CLI'),
+    writeReleasePlan: z
+        .boolean()
+        .default(false)
+        .describe('For create_milestone/push_local_milestones: also render local milestones into RELEASE_PLAN.md (bounded section)'),
+    releasePlanPath: z
+        .string()
+        .default('RELEASE_PLAN.md')
+        .describe('Path to RELEASE_PLAN.md (relative to projectPath)'),
 });
 // ─── Main Export ───────────────────────────────────────────────────
 export async function releaseTracking(args) {
@@ -97,6 +111,8 @@ export async function releaseTracking(args) {
                 return await handleCreateMilestone(projectPath, validatedArgs);
             case 'sync_milestones':
                 return await handleSyncMilestones(projectPath, adrs, validatedArgs);
+            case 'push_local_milestones':
+                return await handlePushLocalMilestones(projectPath, validatedArgs);
             default:
                 throw new McpAdrError('INVALID_ARGS', `Unknown operation: ${validatedArgs.operation}`);
         }
@@ -407,32 +423,114 @@ ${preview.readiness.recommendations.join('\n')}`,
         ],
     });
 }
+function persistLocalMilestone(projectPath, args, pushed, githubNumber) {
+    const id = slugify(args.milestoneTitle);
+    const milestone = {
+        id,
+        name: args.milestoneTitle,
+        completed: 0,
+        total: 0,
+        completionRate: 0,
+        criticalTodos: 0,
+        blockers: [],
+        linkedAdrIds: [],
+        linkedTodoIds: [],
+        source: pushed ? 'github' : 'local',
+        pushed,
+        ...(args.milestoneDescription !== undefined ? { description: args.milestoneDescription } : {}),
+        ...(args.milestoneDueDate !== undefined ? { dueDate: args.milestoneDueDate } : {}),
+        ...(githubNumber !== undefined ? { githubNumber } : {}),
+    };
+    return upsertLocal(projectPath, milestone);
+}
 async function handleCreateMilestone(projectPath, args) {
     if (!args.milestoneTitle) {
         throw new McpAdrError('INVALID_ARGS', 'milestoneTitle is required for create_milestone operation');
     }
-    const result = syncGitHubMilestone(projectPath, args.milestoneTitle, args.milestoneDescription || '', args.milestoneDueDate);
+    let mode = args.localOnly ? 'local-only' : 'github';
+    let ghNumber;
+    let ghError;
+    if (!args.localOnly) {
+        const result = syncGitHubMilestone(projectPath, args.milestoneTitle, args.milestoneDescription || '', args.milestoneDueDate);
+        if (result.success) {
+            ghNumber = result.number;
+        }
+        else {
+            mode = 'local-fallback';
+            ghError = result.error;
+        }
+    }
+    const stored = persistLocalMilestone(projectPath, args, mode === 'github', ghNumber);
+    let releasePlanPath;
+    if (args.writeReleasePlan) {
+        const milestones = listLocal(projectPath);
+        releasePlanPath = writeReleasePlanFile(projectPath, milestones, args.releasePlanPath);
+    }
+    const summary = [];
+    if (mode === 'github') {
+        summary.push(`# Milestone Created/Updated`, ``, `**Title**: ${args.milestoneTitle}`, `**Number**: #${ghNumber}`, `**Local id**: \`${stored.id}\` (cached for offline use)`);
+    }
+    else if (mode === 'local-only') {
+        summary.push(`# Milestone Persisted Locally`, ``, `**Title**: ${args.milestoneTitle}`, `**Local id**: \`${stored.id}\``, `**Storage**: \`.mcp-adr-cache/milestones.local.json\``, ``, `Run \`release_tracking\` with \`operation: "push_local_milestones"\` once \`gh\` auth is configured to publish.`);
+    }
+    else {
+        summary.push(`# Milestone Persisted Locally (gh fallback)`, ``, `**Title**: ${args.milestoneTitle}`, `**Local id**: \`${stored.id}\``, `**Storage**: \`.mcp-adr-cache/milestones.local.json\``, ``, `⚠️ \`gh api\` failed: ${ghError ?? 'unknown error'}.`, ``, `The milestone has been saved locally so the workflow can continue. Resolve gh auth (\`gh auth status\`) then run \`release_tracking\` with \`operation: "push_local_milestones"\` to sync upstream. Pass \`localOnly: true\` to suppress this fallback warning.`);
+    }
+    if (args.milestoneDescription)
+        summary.push(`**Description**: ${args.milestoneDescription}`);
+    if (args.milestoneDueDate)
+        summary.push(`**Due Date**: ${args.milestoneDueDate}`);
+    if (releasePlanPath) {
+        summary.push(``, `📝 RELEASE_PLAN.md updated at \`${releasePlanPath}\``);
+    }
     return validateMcpResponse({
-        content: [
-            {
-                type: 'text',
-                text: result.success
-                    ? `# Milestone Created/Updated
-
-**Title**: ${args.milestoneTitle}
-**Number**: #${result.number}
-${args.milestoneDescription ? `**Description**: ${args.milestoneDescription}` : ''}
-${args.milestoneDueDate ? `**Due Date**: ${args.milestoneDueDate}` : ''}`
-                    : `# Milestone Creation Failed
-
-**Error**: ${result.error}
-
-Make sure:
-1. \`gh\` CLI is installed and authenticated
-2. You have write access to the repository
-3. Run \`gh auth status\` to verify`,
-            },
-        ],
+        content: [{ type: 'text', text: summary.join('\n') }],
+    });
+}
+async function handlePushLocalMilestones(projectPath, args) {
+    const local = listLocal(projectPath);
+    if (local.length === 0) {
+        return validateMcpResponse({
+            content: [
+                {
+                    type: 'text',
+                    text: `# Push Local Milestones\n\nNo local milestones found at \`.mcp-adr-cache/milestones.local.json\`. Create one first via \`release_tracking\` with \`operation: "create_milestone"\` and \`localOnly: true\`.`,
+                },
+            ],
+        });
+    }
+    const lines = [`# Push Local Milestones`, ``, `**Total**: ${local.length}`, ``];
+    let synced = 0;
+    let skipped = 0;
+    let failed = 0;
+    for (const milestone of local) {
+        if (milestone.pushed) {
+            lines.push(`- ⏭️ \`${milestone.id ?? slugify(milestone.name)}\` — already pushed (#${milestone.githubNumber ?? '?'})`);
+            skipped += 1;
+            continue;
+        }
+        const result = syncGitHubMilestone(projectPath, milestone.name, milestone.description ?? '', milestone.dueDate);
+        if (result.success && result.number !== undefined) {
+            markPushed(projectPath, milestone.id ?? slugify(milestone.name), result.number);
+            lines.push(`- ✅ \`${milestone.id ?? slugify(milestone.name)}\` — pushed (#${result.number})`);
+            synced += 1;
+        }
+        else {
+            lines.push(`- ❌ \`${milestone.id ?? slugify(milestone.name)}\` — failed (${result.error ?? 'unknown error'})`);
+            failed += 1;
+        }
+    }
+    lines.push(``, `**Synced**: ${synced} · **Skipped**: ${skipped} · **Failed**: ${failed}`);
+    if (args.writeReleasePlan) {
+        const refreshed = listLocal(projectPath);
+        const path = writeReleasePlanFile(projectPath, refreshed, args.releasePlanPath);
+        lines.push(``, `📝 RELEASE_PLAN.md updated at \`${path}\``);
+    }
+    if (failed > 0) {
+        lines.push(``, `⚠️ Some pushes failed. Run \`gh auth status\` to verify auth and re-invoke \`push_local_milestones\` to retry.`);
+    }
+    return validateMcpResponse({
+        content: [{ type: 'text', text: lines.join('\n') }],
     });
 }
 async function handleSyncMilestones(projectPath, adrs, args) {