@diegonogueiradev_/mcp-graph 1.0.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (233) hide show
  1. package/dist/core/context/compact-context.d.ts +51 -0
  2. package/dist/core/context/compact-context.d.ts.map +1 -0
  3. package/dist/core/context/compact-context.js +115 -0
  4. package/dist/core/context/compact-context.js.map +1 -0
  5. package/dist/core/context/rag-context.d.ts +36 -0
  6. package/dist/core/context/rag-context.d.ts.map +1 -0
  7. package/dist/core/context/rag-context.js +69 -0
  8. package/dist/core/context/rag-context.js.map +1 -0
  9. package/dist/core/context/token-estimator.d.ts +7 -0
  10. package/dist/core/context/token-estimator.d.ts.map +1 -0
  11. package/dist/core/context/token-estimator.js +9 -0
  12. package/dist/core/context/token-estimator.js.map +1 -0
  13. package/dist/core/graph/graph-indexes.d.ts +3 -0
  14. package/dist/core/graph/graph-indexes.d.ts.map +1 -0
  15. package/dist/core/graph/graph-indexes.js +28 -0
  16. package/dist/core/graph/graph-indexes.js.map +1 -0
  17. package/dist/core/graph/graph-types.d.ts +72 -0
  18. package/dist/core/graph/graph-types.d.ts.map +1 -0
  19. package/dist/core/graph/graph-types.js +2 -0
  20. package/dist/core/graph/graph-types.js.map +1 -0
  21. package/dist/core/importer/import-prd.d.ts +7 -0
  22. package/dist/core/importer/import-prd.d.ts.map +1 -0
  23. package/dist/core/importer/import-prd.js +7 -0
  24. package/dist/core/importer/import-prd.js.map +1 -0
  25. package/dist/core/importer/prd-to-graph.d.ts +18 -0
  26. package/dist/core/importer/prd-to-graph.d.ts.map +1 -0
  27. package/dist/core/importer/prd-to-graph.js +188 -0
  28. package/dist/core/importer/prd-to-graph.js.map +1 -0
  29. package/dist/core/parser/classify.d.ts +31 -0
  30. package/dist/core/parser/classify.d.ts.map +1 -0
  31. package/dist/core/parser/classify.js +128 -0
  32. package/dist/core/parser/classify.js.map +1 -0
  33. package/dist/core/parser/extract.d.ts +21 -0
  34. package/dist/core/parser/extract.d.ts.map +1 -0
  35. package/dist/core/parser/extract.js +66 -0
  36. package/dist/core/parser/extract.js.map +1 -0
  37. package/dist/core/parser/normalize.d.ts +9 -0
  38. package/dist/core/parser/normalize.d.ts.map +1 -0
  39. package/dist/core/parser/normalize.js +22 -0
  40. package/dist/core/parser/normalize.js.map +1 -0
  41. package/dist/core/parser/read-file.d.ts +7 -0
  42. package/dist/core/parser/read-file.d.ts.map +1 -0
  43. package/dist/core/parser/read-file.js +17 -0
  44. package/dist/core/parser/read-file.js.map +1 -0
  45. package/dist/core/parser/segment.d.ts +13 -0
  46. package/dist/core/parser/segment.d.ts.map +1 -0
  47. package/dist/core/parser/segment.js +53 -0
  48. package/dist/core/parser/segment.js.map +1 -0
  49. package/dist/core/planner/decompose.d.ts +25 -0
  50. package/dist/core/planner/decompose.d.ts.map +1 -0
  51. package/dist/core/planner/decompose.js +100 -0
  52. package/dist/core/planner/decompose.js.map +1 -0
  53. package/dist/core/planner/dependency-chain.d.ts +20 -0
  54. package/dist/core/planner/dependency-chain.d.ts.map +1 -0
  55. package/dist/core/planner/dependency-chain.js +163 -0
  56. package/dist/core/planner/dependency-chain.js.map +1 -0
  57. package/dist/core/planner/next-task.d.ts +16 -0
  58. package/dist/core/planner/next-task.d.ts.map +1 -0
  59. package/dist/core/planner/next-task.js +76 -0
  60. package/dist/core/planner/next-task.js.map +1 -0
  61. package/dist/core/planner/velocity.d.ts +38 -0
  62. package/dist/core/planner/velocity.d.ts.map +1 -0
  63. package/dist/core/planner/velocity.js +92 -0
  64. package/dist/core/planner/velocity.js.map +1 -0
  65. package/dist/core/search/fts-search.d.ts +16 -0
  66. package/dist/core/search/fts-search.d.ts.map +1 -0
  67. package/dist/core/search/fts-search.js +57 -0
  68. package/dist/core/search/fts-search.js.map +1 -0
  69. package/dist/core/search/tfidf.d.ts +32 -0
  70. package/dist/core/search/tfidf.d.ts.map +1 -0
  71. package/dist/core/search/tfidf.js +67 -0
  72. package/dist/core/search/tfidf.js.map +1 -0
  73. package/dist/core/search/tokenizer.d.ts +9 -0
  74. package/dist/core/search/tokenizer.d.ts.map +1 -0
  75. package/dist/core/search/tokenizer.js +37 -0
  76. package/dist/core/search/tokenizer.js.map +1 -0
  77. package/dist/core/store/migrations.d.ts +4 -0
  78. package/dist/core/store/migrations.d.ts.map +1 -0
  79. package/dist/core/store/migrations.js +137 -0
  80. package/dist/core/store/migrations.js.map +1 -0
  81. package/dist/core/store/sqlite-store.d.ts +68 -0
  82. package/dist/core/store/sqlite-store.d.ts.map +1 -0
  83. package/dist/core/store/sqlite-store.js +608 -0
  84. package/dist/core/store/sqlite-store.js.map +1 -0
  85. package/dist/core/utils/errors.d.ts +20 -0
  86. package/dist/core/utils/errors.d.ts.map +1 -0
  87. package/dist/core/utils/errors.js +39 -0
  88. package/dist/core/utils/errors.js.map +1 -0
  89. package/dist/core/utils/fs.d.ts +2 -0
  90. package/dist/core/utils/fs.d.ts.map +1 -0
  91. package/dist/core/utils/fs.js +11 -0
  92. package/dist/core/utils/fs.js.map +1 -0
  93. package/dist/core/utils/id.d.ts +2 -0
  94. package/dist/core/utils/id.d.ts.map +1 -0
  95. package/dist/core/utils/id.js +6 -0
  96. package/dist/core/utils/id.js.map +1 -0
  97. package/dist/core/utils/logger.d.ts +7 -0
  98. package/dist/core/utils/logger.d.ts.map +1 -0
  99. package/dist/core/utils/logger.js +23 -0
  100. package/dist/core/utils/logger.js.map +1 -0
  101. package/dist/core/utils/time.d.ts +2 -0
  102. package/dist/core/utils/time.d.ts.map +1 -0
  103. package/dist/core/utils/time.js +4 -0
  104. package/dist/core/utils/time.js.map +1 -0
  105. package/dist/index.d.ts +10 -0
  106. package/dist/index.d.ts.map +1 -0
  107. package/dist/index.js +9 -0
  108. package/dist/index.js.map +1 -0
  109. package/dist/mcp/init-project.d.ts +2 -0
  110. package/dist/mcp/init-project.d.ts.map +1 -0
  111. package/dist/mcp/init-project.js +104 -0
  112. package/dist/mcp/init-project.js.map +1 -0
  113. package/dist/mcp/server.d.ts +2 -0
  114. package/dist/mcp/server.d.ts.map +1 -0
  115. package/dist/mcp/server.js +30 -0
  116. package/dist/mcp/server.js.map +1 -0
  117. package/dist/mcp/stdio.d.ts +3 -0
  118. package/dist/mcp/stdio.d.ts.map +1 -0
  119. package/dist/mcp/stdio.js +20 -0
  120. package/dist/mcp/stdio.js.map +1 -0
  121. package/dist/mcp/tools/add-edge.d.ts +4 -0
  122. package/dist/mcp/tools/add-edge.d.ts.map +1 -0
  123. package/dist/mcp/tools/add-edge.js +62 -0
  124. package/dist/mcp/tools/add-edge.js.map +1 -0
  125. package/dist/mcp/tools/add-node.d.ts +4 -0
  126. package/dist/mcp/tools/add-node.d.ts.map +1 -0
  127. package/dist/mcp/tools/add-node.js +80 -0
  128. package/dist/mcp/tools/add-node.js.map +1 -0
  129. package/dist/mcp/tools/bulk-update-status.d.ts +4 -0
  130. package/dist/mcp/tools/bulk-update-status.d.ts.map +1 -0
  131. package/dist/mcp/tools/bulk-update-status.js +19 -0
  132. package/dist/mcp/tools/bulk-update-status.js.map +1 -0
  133. package/dist/mcp/tools/clone-node.d.ts +4 -0
  134. package/dist/mcp/tools/clone-node.d.ts.map +1 -0
  135. package/dist/mcp/tools/clone-node.js +107 -0
  136. package/dist/mcp/tools/clone-node.js.map +1 -0
  137. package/dist/mcp/tools/context.d.ts +4 -0
  138. package/dist/mcp/tools/context.d.ts.map +1 -0
  139. package/dist/mcp/tools/context.js +26 -0
  140. package/dist/mcp/tools/context.js.map +1 -0
  141. package/dist/mcp/tools/decompose.d.ts +4 -0
  142. package/dist/mcp/tools/decompose.d.ts.map +1 -0
  143. package/dist/mcp/tools/decompose.js +22 -0
  144. package/dist/mcp/tools/decompose.js.map +1 -0
  145. package/dist/mcp/tools/delete-edge.d.ts +4 -0
  146. package/dist/mcp/tools/delete-edge.d.ts.map +1 -0
  147. package/dist/mcp/tools/delete-edge.js +25 -0
  148. package/dist/mcp/tools/delete-edge.js.map +1 -0
  149. package/dist/mcp/tools/delete-node.d.ts +4 -0
  150. package/dist/mcp/tools/delete-node.d.ts.map +1 -0
  151. package/dist/mcp/tools/delete-node.js +25 -0
  152. package/dist/mcp/tools/delete-node.js.map +1 -0
  153. package/dist/mcp/tools/dependencies.d.ts +4 -0
  154. package/dist/mcp/tools/dependencies.d.ts.map +1 -0
  155. package/dist/mcp/tools/dependencies.js +42 -0
  156. package/dist/mcp/tools/dependencies.js.map +1 -0
  157. package/dist/mcp/tools/export-graph.d.ts +4 -0
  158. package/dist/mcp/tools/export-graph.d.ts.map +1 -0
  159. package/dist/mcp/tools/export-graph.js +14 -0
  160. package/dist/mcp/tools/export-graph.js.map +1 -0
  161. package/dist/mcp/tools/import-prd.d.ts +4 -0
  162. package/dist/mcp/tools/import-prd.d.ts.map +1 -0
  163. package/dist/mcp/tools/import-prd.js +72 -0
  164. package/dist/mcp/tools/import-prd.js.map +1 -0
  165. package/dist/mcp/tools/index.d.ts +4 -0
  166. package/dist/mcp/tools/index.d.ts.map +1 -0
  167. package/dist/mcp/tools/index.js +53 -0
  168. package/dist/mcp/tools/index.js.map +1 -0
  169. package/dist/mcp/tools/init.d.ts +4 -0
  170. package/dist/mcp/tools/init.d.ts.map +1 -0
  171. package/dist/mcp/tools/init.js +15 -0
  172. package/dist/mcp/tools/init.js.map +1 -0
  173. package/dist/mcp/tools/list-edges.d.ts +4 -0
  174. package/dist/mcp/tools/list-edges.d.ts.map +1 -0
  175. package/dist/mcp/tools/list-edges.js +49 -0
  176. package/dist/mcp/tools/list-edges.js.map +1 -0
  177. package/dist/mcp/tools/list.d.ts +4 -0
  178. package/dist/mcp/tools/list.d.ts.map +1 -0
  179. package/dist/mcp/tools/list.js +53 -0
  180. package/dist/mcp/tools/list.js.map +1 -0
  181. package/dist/mcp/tools/move-node.d.ts +4 -0
  182. package/dist/mcp/tools/move-node.d.ts.map +1 -0
  183. package/dist/mcp/tools/move-node.js +107 -0
  184. package/dist/mcp/tools/move-node.js.map +1 -0
  185. package/dist/mcp/tools/next.d.ts +4 -0
  186. package/dist/mcp/tools/next.d.ts.map +1 -0
  187. package/dist/mcp/tools/next.js +28 -0
  188. package/dist/mcp/tools/next.js.map +1 -0
  189. package/dist/mcp/tools/rag-context.d.ts +4 -0
  190. package/dist/mcp/tools/rag-context.d.ts.map +1 -0
  191. package/dist/mcp/tools/rag-context.js +25 -0
  192. package/dist/mcp/tools/rag-context.js.map +1 -0
  193. package/dist/mcp/tools/search.d.ts +4 -0
  194. package/dist/mcp/tools/search.d.ts.map +1 -0
  195. package/dist/mcp/tools/search.js +38 -0
  196. package/dist/mcp/tools/search.js.map +1 -0
  197. package/dist/mcp/tools/show.d.ts +4 -0
  198. package/dist/mcp/tools/show.d.ts.map +1 -0
  199. package/dist/mcp/tools/show.js +38 -0
  200. package/dist/mcp/tools/show.js.map +1 -0
  201. package/dist/mcp/tools/snapshot.d.ts +6 -0
  202. package/dist/mcp/tools/snapshot.d.ts.map +1 -0
  203. package/dist/mcp/tools/snapshot.js +43 -0
  204. package/dist/mcp/tools/snapshot.js.map +1 -0
  205. package/dist/mcp/tools/stats.d.ts +4 -0
  206. package/dist/mcp/tools/stats.d.ts.map +1 -0
  207. package/dist/mcp/tools/stats.js +43 -0
  208. package/dist/mcp/tools/stats.js.map +1 -0
  209. package/dist/mcp/tools/update-node.d.ts +4 -0
  210. package/dist/mcp/tools/update-node.d.ts.map +1 -0
  211. package/dist/mcp/tools/update-node.js +41 -0
  212. package/dist/mcp/tools/update-node.js.map +1 -0
  213. package/dist/mcp/tools/update-status.d.ts +4 -0
  214. package/dist/mcp/tools/update-status.d.ts.map +1 -0
  215. package/dist/mcp/tools/update-status.js +29 -0
  216. package/dist/mcp/tools/update-status.js.map +1 -0
  217. package/dist/mcp/tools/velocity.d.ts +4 -0
  218. package/dist/mcp/tools/velocity.d.ts.map +1 -0
  219. package/dist/mcp/tools/velocity.js +22 -0
  220. package/dist/mcp/tools/velocity.js.map +1 -0
  221. package/dist/schemas/edge.schema.d.ts +31 -0
  222. package/dist/schemas/edge.schema.d.ts.map +1 -0
  223. package/dist/schemas/edge.schema.js +16 -0
  224. package/dist/schemas/edge.schema.js.map +1 -0
  225. package/dist/schemas/graph.schema.d.ts +102 -0
  226. package/dist/schemas/graph.schema.d.ts.map +1 -0
  227. package/dist/schemas/graph.schema.js +28 -0
  228. package/dist/schemas/graph.schema.js.map +1 -0
  229. package/dist/schemas/node.schema.d.ts +80 -0
  230. package/dist/schemas/node.schema.d.ts.map +1 -0
  231. package/dist/schemas/node.schema.js +38 -0
  232. package/dist/schemas/node.schema.js.map +1 -0
  233. package/package.json +54 -0
@@ -0,0 +1,22 @@
1
+ import { z } from "zod/v4";
2
+ import { calculateVelocity } from "../../core/planner/velocity.js";
3
+ export function registerVelocity(server, store) {
4
+ server.tool("velocity", "Calculate sprint velocity metrics (tasks completed, points, avg completion time)", {
5
+ sprint: z.string().optional().describe("Filter results to a specific sprint"),
6
+ }, async ({ sprint }) => {
7
+ const doc = store.toGraphDocument();
8
+ const summary = calculateVelocity(doc);
9
+ if (sprint) {
10
+ summary.sprints = summary.sprints.filter((s) => s.sprint === sprint);
11
+ }
12
+ return {
13
+ content: [
14
+ {
15
+ type: "text",
16
+ text: JSON.stringify({ ok: true, ...summary }, null, 2),
17
+ },
18
+ ],
19
+ };
20
+ });
21
+ }
22
+ //# sourceMappingURL=velocity.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"velocity.js","sourceRoot":"","sources":["../../../src/mcp/tools/velocity.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,QAAQ,CAAC;AAG3B,OAAO,EAAE,iBAAiB,EAAE,MAAM,gCAAgC,CAAC;AAEnE,MAAM,UAAU,gBAAgB,CAAC,MAAiB,EAAE,KAAkB;IACpE,MAAM,CAAC,IAAI,CACT,UAAU,EACV,kFAAkF,EAClF;QACE,MAAM,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,qCAAqC,CAAC;KAC9E,EACD,KAAK,EAAE,EAAE,MAAM,EAAE,EAAE,EAAE;QACnB,MAAM,GAAG,GAAG,KAAK,CAAC,eAAe,EAAE,CAAC;QACpC,MAAM,OAAO,GAAG,iBAAiB,CAAC,GAAG,CAAC,CAAC;QAEvC,IAAI,MAAM,EAAE,CAAC;YACX,OAAO,CAAC,OAAO,GAAG,OAAO,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,MAAM,KAAK,MAAM,CAAC,CAAC;QACvE,CAAC;QAED,OAAO;YACL,OAAO,EAAE;gBACP;oBACE,IAAI,EAAE,MAAe;oBACrB,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,EAAE,EAAE,EAAE,IAAI,EAAE,GAAG,OAAO,EAAE,EAAE,IAAI,EAAE,CAAC,CAAC;iBACxD;aACF;SACF,CAAC;IACJ,CAAC,CACF,CAAC;AACJ,CAAC"}
@@ -0,0 +1,31 @@
1
+ import { z } from "zod/v4";
2
+ export declare const RelationTypeSchema: z.ZodEnum<{
3
+ parent_of: "parent_of";
4
+ child_of: "child_of";
5
+ depends_on: "depends_on";
6
+ blocks: "blocks";
7
+ related_to: "related_to";
8
+ priority_over: "priority_over";
9
+ implements: "implements";
10
+ derived_from: "derived_from";
11
+ }>;
12
+ export declare const GraphEdgeSchema: z.ZodObject<{
13
+ id: z.ZodString;
14
+ from: z.ZodString;
15
+ to: z.ZodString;
16
+ relationType: z.ZodEnum<{
17
+ parent_of: "parent_of";
18
+ child_of: "child_of";
19
+ depends_on: "depends_on";
20
+ blocks: "blocks";
21
+ related_to: "related_to";
22
+ priority_over: "priority_over";
23
+ implements: "implements";
24
+ derived_from: "derived_from";
25
+ }>;
26
+ weight: z.ZodOptional<z.ZodNumber>;
27
+ reason: z.ZodOptional<z.ZodString>;
28
+ metadata: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
29
+ createdAt: z.ZodString;
30
+ }, z.core.$strip>;
31
+ //# sourceMappingURL=edge.schema.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"edge.schema.d.ts","sourceRoot":"","sources":["../../src/schemas/edge.schema.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,QAAQ,CAAC;AAE3B,eAAO,MAAM,kBAAkB;;;;;;;;;EAG7B,CAAC;AAEH,eAAO,MAAM,eAAe;;;;;;;;;;;;;;;;;;iBAS1B,CAAC"}
@@ -0,0 +1,16 @@
1
+ import { z } from "zod/v4";
2
+ export const RelationTypeSchema = z.enum([
3
+ "parent_of", "child_of", "depends_on", "blocks",
4
+ "related_to", "priority_over", "implements", "derived_from",
5
+ ]);
6
+ export const GraphEdgeSchema = z.object({
7
+ id: z.string(),
8
+ from: z.string(),
9
+ to: z.string(),
10
+ relationType: RelationTypeSchema,
11
+ weight: z.number().optional(),
12
+ reason: z.string().optional(),
13
+ metadata: z.record(z.string(), z.unknown()).optional(),
14
+ createdAt: z.string(),
15
+ });
16
+ //# sourceMappingURL=edge.schema.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"edge.schema.js","sourceRoot":"","sources":["../../src/schemas/edge.schema.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,QAAQ,CAAC;AAE3B,MAAM,CAAC,MAAM,kBAAkB,GAAG,CAAC,CAAC,IAAI,CAAC;IACvC,WAAW,EAAE,UAAU,EAAE,YAAY,EAAE,QAAQ;IAC/C,YAAY,EAAE,eAAe,EAAE,YAAY,EAAE,cAAc;CAC5D,CAAC,CAAC;AAEH,MAAM,CAAC,MAAM,eAAe,GAAG,CAAC,CAAC,MAAM,CAAC;IACtC,EAAE,EAAE,CAAC,CAAC,MAAM,EAAE;IACd,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE;IAChB,EAAE,EAAE,CAAC,CAAC,MAAM,EAAE;IACd,YAAY,EAAE,kBAAkB;IAChC,MAAM,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;IAC7B,MAAM,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;IAC7B,QAAQ,EAAE,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC,OAAO,EAAE,CAAC,CAAC,QAAQ,EAAE;IACtD,SAAS,EAAE,CAAC,CAAC,MAAM,EAAE;CACtB,CAAC,CAAC"}
@@ -0,0 +1,102 @@
1
+ import { z } from "zod/v4";
2
+ export declare const GraphIndexesSchema: z.ZodObject<{
3
+ byId: z.ZodRecord<z.ZodString, z.ZodNumber>;
4
+ childrenByParent: z.ZodRecord<z.ZodString, z.ZodArray<z.ZodString>>;
5
+ incomingByNode: z.ZodRecord<z.ZodString, z.ZodArray<z.ZodString>>;
6
+ outgoingByNode: z.ZodRecord<z.ZodString, z.ZodArray<z.ZodString>>;
7
+ }, z.core.$strip>;
8
+ export declare const GraphProjectSchema: z.ZodObject<{
9
+ id: z.ZodString;
10
+ name: z.ZodString;
11
+ createdAt: z.ZodString;
12
+ updatedAt: z.ZodString;
13
+ }, z.core.$strip>;
14
+ export declare const GraphMetaSchema: z.ZodObject<{
15
+ sourceFiles: z.ZodArray<z.ZodString>;
16
+ lastImport: z.ZodNullable<z.ZodString>;
17
+ }, z.core.$strip>;
18
+ export declare const GraphDocumentSchema: z.ZodObject<{
19
+ version: z.ZodString;
20
+ project: z.ZodObject<{
21
+ id: z.ZodString;
22
+ name: z.ZodString;
23
+ createdAt: z.ZodString;
24
+ updatedAt: z.ZodString;
25
+ }, z.core.$strip>;
26
+ nodes: z.ZodArray<z.ZodObject<{
27
+ id: z.ZodString;
28
+ type: z.ZodEnum<{
29
+ epic: "epic";
30
+ task: "task";
31
+ subtask: "subtask";
32
+ requirement: "requirement";
33
+ constraint: "constraint";
34
+ milestone: "milestone";
35
+ acceptance_criteria: "acceptance_criteria";
36
+ risk: "risk";
37
+ decision: "decision";
38
+ }>;
39
+ title: z.ZodString;
40
+ description: z.ZodOptional<z.ZodString>;
41
+ status: z.ZodEnum<{
42
+ backlog: "backlog";
43
+ ready: "ready";
44
+ in_progress: "in_progress";
45
+ blocked: "blocked";
46
+ done: "done";
47
+ }>;
48
+ priority: z.ZodUnion<readonly [z.ZodLiteral<1>, z.ZodLiteral<2>, z.ZodLiteral<3>, z.ZodLiteral<4>, z.ZodLiteral<5>]>;
49
+ xpSize: z.ZodOptional<z.ZodEnum<{
50
+ XS: "XS";
51
+ S: "S";
52
+ M: "M";
53
+ L: "L";
54
+ XL: "XL";
55
+ }>>;
56
+ estimateMinutes: z.ZodOptional<z.ZodNumber>;
57
+ tags: z.ZodOptional<z.ZodArray<z.ZodString>>;
58
+ parentId: z.ZodOptional<z.ZodNullable<z.ZodString>>;
59
+ sprint: z.ZodOptional<z.ZodNullable<z.ZodString>>;
60
+ sourceRef: z.ZodOptional<z.ZodObject<{
61
+ file: z.ZodString;
62
+ startLine: z.ZodOptional<z.ZodNumber>;
63
+ endLine: z.ZodOptional<z.ZodNumber>;
64
+ confidence: z.ZodOptional<z.ZodNumber>;
65
+ }, z.core.$strip>>;
66
+ acceptanceCriteria: z.ZodOptional<z.ZodArray<z.ZodString>>;
67
+ blocked: z.ZodOptional<z.ZodBoolean>;
68
+ metadata: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
69
+ createdAt: z.ZodString;
70
+ updatedAt: z.ZodString;
71
+ }, z.core.$strip>>;
72
+ edges: z.ZodArray<z.ZodObject<{
73
+ id: z.ZodString;
74
+ from: z.ZodString;
75
+ to: z.ZodString;
76
+ relationType: z.ZodEnum<{
77
+ parent_of: "parent_of";
78
+ child_of: "child_of";
79
+ depends_on: "depends_on";
80
+ blocks: "blocks";
81
+ related_to: "related_to";
82
+ priority_over: "priority_over";
83
+ implements: "implements";
84
+ derived_from: "derived_from";
85
+ }>;
86
+ weight: z.ZodOptional<z.ZodNumber>;
87
+ reason: z.ZodOptional<z.ZodString>;
88
+ metadata: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
89
+ createdAt: z.ZodString;
90
+ }, z.core.$strip>>;
91
+ indexes: z.ZodObject<{
92
+ byId: z.ZodRecord<z.ZodString, z.ZodNumber>;
93
+ childrenByParent: z.ZodRecord<z.ZodString, z.ZodArray<z.ZodString>>;
94
+ incomingByNode: z.ZodRecord<z.ZodString, z.ZodArray<z.ZodString>>;
95
+ outgoingByNode: z.ZodRecord<z.ZodString, z.ZodArray<z.ZodString>>;
96
+ }, z.core.$strip>;
97
+ meta: z.ZodObject<{
98
+ sourceFiles: z.ZodArray<z.ZodString>;
99
+ lastImport: z.ZodNullable<z.ZodString>;
100
+ }, z.core.$strip>;
101
+ }, z.core.$strip>;
102
+ //# sourceMappingURL=graph.schema.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"graph.schema.d.ts","sourceRoot":"","sources":["../../src/schemas/graph.schema.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,QAAQ,CAAC;AAI3B,eAAO,MAAM,kBAAkB;;;;;iBAK7B,CAAC;AAEH,eAAO,MAAM,kBAAkB;;;;;iBAK7B,CAAC;AAEH,eAAO,MAAM,eAAe;;;iBAG1B,CAAC;AAEH,eAAO,MAAM,mBAAmB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;iBAO9B,CAAC"}
@@ -0,0 +1,28 @@
1
+ import { z } from "zod/v4";
2
+ import { GraphNodeSchema } from "./node.schema.js";
3
+ import { GraphEdgeSchema } from "./edge.schema.js";
4
+ export const GraphIndexesSchema = z.object({
5
+ byId: z.record(z.string(), z.number()),
6
+ childrenByParent: z.record(z.string(), z.array(z.string())),
7
+ incomingByNode: z.record(z.string(), z.array(z.string())),
8
+ outgoingByNode: z.record(z.string(), z.array(z.string())),
9
+ });
10
+ export const GraphProjectSchema = z.object({
11
+ id: z.string(),
12
+ name: z.string(),
13
+ createdAt: z.string(),
14
+ updatedAt: z.string(),
15
+ });
16
+ export const GraphMetaSchema = z.object({
17
+ sourceFiles: z.array(z.string()),
18
+ lastImport: z.string().nullable(),
19
+ });
20
+ export const GraphDocumentSchema = z.object({
21
+ version: z.string(),
22
+ project: GraphProjectSchema,
23
+ nodes: z.array(GraphNodeSchema),
24
+ edges: z.array(GraphEdgeSchema),
25
+ indexes: GraphIndexesSchema,
26
+ meta: GraphMetaSchema,
27
+ });
28
+ //# sourceMappingURL=graph.schema.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"graph.schema.js","sourceRoot":"","sources":["../../src/schemas/graph.schema.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,QAAQ,CAAC;AAC3B,OAAO,EAAE,eAAe,EAAE,MAAM,kBAAkB,CAAC;AACnD,OAAO,EAAE,eAAe,EAAE,MAAM,kBAAkB,CAAC;AAEnD,MAAM,CAAC,MAAM,kBAAkB,GAAG,CAAC,CAAC,MAAM,CAAC;IACzC,IAAI,EAAE,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC;IACtC,gBAAgB,EAAE,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC,CAAC;IAC3D,cAAc,EAAE,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC,CAAC;IACzD,cAAc,EAAE,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC,CAAC;CAC1D,CAAC,CAAC;AAEH,MAAM,CAAC,MAAM,kBAAkB,GAAG,CAAC,CAAC,MAAM,CAAC;IACzC,EAAE,EAAE,CAAC,CAAC,MAAM,EAAE;IACd,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE;IAChB,SAAS,EAAE,CAAC,CAAC,MAAM,EAAE;IACrB,SAAS,EAAE,CAAC,CAAC,MAAM,EAAE;CACtB,CAAC,CAAC;AAEH,MAAM,CAAC,MAAM,eAAe,GAAG,CAAC,CAAC,MAAM,CAAC;IACtC,WAAW,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC;IAChC,UAAU,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;CAClC,CAAC,CAAC;AAEH,MAAM,CAAC,MAAM,mBAAmB,GAAG,CAAC,CAAC,MAAM,CAAC;IAC1C,OAAO,EAAE,CAAC,CAAC,MAAM,EAAE;IACnB,OAAO,EAAE,kBAAkB;IAC3B,KAAK,EAAE,CAAC,CAAC,KAAK,CAAC,eAAe,CAAC;IAC/B,KAAK,EAAE,CAAC,CAAC,KAAK,CAAC,eAAe,CAAC;IAC/B,OAAO,EAAE,kBAAkB;IAC3B,IAAI,EAAE,eAAe;CACtB,CAAC,CAAC"}
@@ -0,0 +1,80 @@
1
+ import { z } from "zod/v4";
2
+ export declare const NodeTypeSchema: z.ZodEnum<{
3
+ epic: "epic";
4
+ task: "task";
5
+ subtask: "subtask";
6
+ requirement: "requirement";
7
+ constraint: "constraint";
8
+ milestone: "milestone";
9
+ acceptance_criteria: "acceptance_criteria";
10
+ risk: "risk";
11
+ decision: "decision";
12
+ }>;
13
+ export declare const NodeStatusSchema: z.ZodEnum<{
14
+ backlog: "backlog";
15
+ ready: "ready";
16
+ in_progress: "in_progress";
17
+ blocked: "blocked";
18
+ done: "done";
19
+ }>;
20
+ export declare const XpSizeSchema: z.ZodEnum<{
21
+ XS: "XS";
22
+ S: "S";
23
+ M: "M";
24
+ L: "L";
25
+ XL: "XL";
26
+ }>;
27
+ export declare const PrioritySchema: z.ZodUnion<readonly [z.ZodLiteral<1>, z.ZodLiteral<2>, z.ZodLiteral<3>, z.ZodLiteral<4>, z.ZodLiteral<5>]>;
28
+ export declare const SourceRefSchema: z.ZodObject<{
29
+ file: z.ZodString;
30
+ startLine: z.ZodOptional<z.ZodNumber>;
31
+ endLine: z.ZodOptional<z.ZodNumber>;
32
+ confidence: z.ZodOptional<z.ZodNumber>;
33
+ }, z.core.$strip>;
34
+ export declare const GraphNodeSchema: z.ZodObject<{
35
+ id: z.ZodString;
36
+ type: z.ZodEnum<{
37
+ epic: "epic";
38
+ task: "task";
39
+ subtask: "subtask";
40
+ requirement: "requirement";
41
+ constraint: "constraint";
42
+ milestone: "milestone";
43
+ acceptance_criteria: "acceptance_criteria";
44
+ risk: "risk";
45
+ decision: "decision";
46
+ }>;
47
+ title: z.ZodString;
48
+ description: z.ZodOptional<z.ZodString>;
49
+ status: z.ZodEnum<{
50
+ backlog: "backlog";
51
+ ready: "ready";
52
+ in_progress: "in_progress";
53
+ blocked: "blocked";
54
+ done: "done";
55
+ }>;
56
+ priority: z.ZodUnion<readonly [z.ZodLiteral<1>, z.ZodLiteral<2>, z.ZodLiteral<3>, z.ZodLiteral<4>, z.ZodLiteral<5>]>;
57
+ xpSize: z.ZodOptional<z.ZodEnum<{
58
+ XS: "XS";
59
+ S: "S";
60
+ M: "M";
61
+ L: "L";
62
+ XL: "XL";
63
+ }>>;
64
+ estimateMinutes: z.ZodOptional<z.ZodNumber>;
65
+ tags: z.ZodOptional<z.ZodArray<z.ZodString>>;
66
+ parentId: z.ZodOptional<z.ZodNullable<z.ZodString>>;
67
+ sprint: z.ZodOptional<z.ZodNullable<z.ZodString>>;
68
+ sourceRef: z.ZodOptional<z.ZodObject<{
69
+ file: z.ZodString;
70
+ startLine: z.ZodOptional<z.ZodNumber>;
71
+ endLine: z.ZodOptional<z.ZodNumber>;
72
+ confidence: z.ZodOptional<z.ZodNumber>;
73
+ }, z.core.$strip>>;
74
+ acceptanceCriteria: z.ZodOptional<z.ZodArray<z.ZodString>>;
75
+ blocked: z.ZodOptional<z.ZodBoolean>;
76
+ metadata: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
77
+ createdAt: z.ZodString;
78
+ updatedAt: z.ZodString;
79
+ }, z.core.$strip>;
80
+ //# sourceMappingURL=node.schema.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"node.schema.d.ts","sourceRoot":"","sources":["../../src/schemas/node.schema.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,QAAQ,CAAC;AAE3B,eAAO,MAAM,cAAc;;;;;;;;;;EAGzB,CAAC;AAEH,eAAO,MAAM,gBAAgB;;;;;;EAE3B,CAAC;AAEH,eAAO,MAAM,YAAY;;;;;;EAAsC,CAAC;AAEhE,eAAO,MAAM,cAAc,4GAEzB,CAAC;AAEH,eAAO,MAAM,eAAe;;;;;iBAK1B,CAAC;AAEH,eAAO,MAAM,eAAe;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;iBAkB1B,CAAC"}
@@ -0,0 +1,38 @@
1
+ import { z } from "zod/v4";
2
+ export const NodeTypeSchema = z.enum([
3
+ "epic", "task", "subtask", "requirement", "constraint",
4
+ "milestone", "acceptance_criteria", "risk", "decision",
5
+ ]);
6
+ export const NodeStatusSchema = z.enum([
7
+ "backlog", "ready", "in_progress", "blocked", "done",
8
+ ]);
9
+ export const XpSizeSchema = z.enum(["XS", "S", "M", "L", "XL"]);
10
+ export const PrioritySchema = z.union([
11
+ z.literal(1), z.literal(2), z.literal(3), z.literal(4), z.literal(5),
12
+ ]);
13
+ export const SourceRefSchema = z.object({
14
+ file: z.string(),
15
+ startLine: z.number().optional(),
16
+ endLine: z.number().optional(),
17
+ confidence: z.number().min(0).max(1).optional(),
18
+ });
19
+ export const GraphNodeSchema = z.object({
20
+ id: z.string(),
21
+ type: NodeTypeSchema,
22
+ title: z.string(),
23
+ description: z.string().optional(),
24
+ status: NodeStatusSchema,
25
+ priority: PrioritySchema,
26
+ xpSize: XpSizeSchema.optional(),
27
+ estimateMinutes: z.number().optional(),
28
+ tags: z.array(z.string()).optional(),
29
+ parentId: z.string().nullable().optional(),
30
+ sprint: z.string().nullable().optional(),
31
+ sourceRef: SourceRefSchema.optional(),
32
+ acceptanceCriteria: z.array(z.string()).optional(),
33
+ blocked: z.boolean().optional(),
34
+ metadata: z.record(z.string(), z.unknown()).optional(),
35
+ createdAt: z.string(),
36
+ updatedAt: z.string(),
37
+ });
38
+ //# sourceMappingURL=node.schema.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"node.schema.js","sourceRoot":"","sources":["../../src/schemas/node.schema.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,QAAQ,CAAC;AAE3B,MAAM,CAAC,MAAM,cAAc,GAAG,CAAC,CAAC,IAAI,CAAC;IACnC,MAAM,EAAE,MAAM,EAAE,SAAS,EAAE,aAAa,EAAE,YAAY;IACtD,WAAW,EAAE,qBAAqB,EAAE,MAAM,EAAE,UAAU;CACvD,CAAC,CAAC;AAEH,MAAM,CAAC,MAAM,gBAAgB,GAAG,CAAC,CAAC,IAAI,CAAC;IACrC,SAAS,EAAE,OAAO,EAAE,aAAa,EAAE,SAAS,EAAE,MAAM;CACrD,CAAC,CAAC;AAEH,MAAM,CAAC,MAAM,YAAY,GAAG,CAAC,CAAC,IAAI,CAAC,CAAC,IAAI,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,IAAI,CAAC,CAAC,CAAC;AAEhE,MAAM,CAAC,MAAM,cAAc,GAAG,CAAC,CAAC,KAAK,CAAC;IACpC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC;CACrE,CAAC,CAAC;AAEH,MAAM,CAAC,MAAM,eAAe,GAAG,CAAC,CAAC,MAAM,CAAC;IACtC,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE;IAChB,SAAS,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;IAChC,OAAO,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;IAC9B,UAAU,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,QAAQ,EAAE;CAChD,CAAC,CAAC;AAEH,MAAM,CAAC,MAAM,eAAe,GAAG,CAAC,CAAC,MAAM,CAAC;IACtC,EAAE,EAAE,CAAC,CAAC,MAAM,EAAE;IACd,IAAI,EAAE,cAAc;IACpB,KAAK,EAAE,CAAC,CAAC,MAAM,EAAE;IACjB,WAAW,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;IAClC,MAAM,EAAE,gBAAgB;IACxB,QAAQ,EAAE,cAAc;IACxB,MAAM,EAAE,YAAY,CAAC,QAAQ,EAAE;IAC/B,eAAe,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;IACtC,IAAI,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC,CAAC,QAAQ,EAAE;IACpC,QAAQ,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,EAAE;IAC1C,MAAM,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,EAAE;IACxC,SAAS,EAAE,eAAe,CAAC,QAAQ,EAAE;IACrC,kBAAkB,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC,CAAC,QAAQ,EAAE;IAClD,OAAO,EAAE,CAAC,CAAC,OAAO,EAAE,CAAC,QAAQ,EAAE;IAC/B,QAAQ,EAAE,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC,OAAO,EAAE,CAAC,CAAC,QAAQ,EAAE;IACtD,SAAS,EAAE,CAAC,CAAC,MAAM,EAAE;IACrB,SAAS,EAAE,CAAC,CAAC,MAAM,EAAE;CACtB,CAAC,CAAC"}
package/package.json ADDED
@@ -0,0 +1,54 @@
1
+ {
2
+ "name": "@diegonogueiradev_/mcp-graph",
3
+ "version": "1.0.0",
4
+ "description": "MCP local-first PRD to task graph — transforms text into executable structure",
5
+ "type": "module",
6
+ "main": "dist/index.js",
7
+ "bin": {
8
+ "mcp-graph": "dist/mcp/stdio.js",
9
+ "mcp-graph-server": "dist/mcp/server.js"
10
+ },
11
+ "scripts": {
12
+ "prepublishOnly": "npm run build && npm test",
13
+ "dev": "tsx src/mcp/server.ts",
14
+ "dev:stdio": "tsx src/mcp/stdio.ts",
15
+ "build": "tsc",
16
+ "start": "node dist/mcp/server.js",
17
+ "test": "vitest run",
18
+ "test:watch": "vitest",
19
+ "typecheck": "tsc --noEmit",
20
+ "lint": "tsc --noEmit",
21
+ "setup:mcp": "bash scripts/setup-mcp.sh"
22
+ },
23
+ "keywords": [
24
+ "mcp",
25
+ "prd",
26
+ "task-graph",
27
+ "local-first",
28
+ "agent-tooling"
29
+ ],
30
+ "files": [
31
+ "dist/",
32
+ "README.md",
33
+ "LICENSE"
34
+ ],
35
+ "license": "MIT",
36
+ "engines": {
37
+ "node": ">=18.0.0"
38
+ },
39
+ "devDependencies": {
40
+ "@types/better-sqlite3": "^7.6.13",
41
+ "@types/express": "^5.0.6",
42
+ "@types/node": "^25.3.3",
43
+ "tsx": "^4.21.0",
44
+ "typescript": "^5.9.3",
45
+ "vitest": "^4.0.18"
46
+ },
47
+ "dependencies": {
48
+ "@modelcontextprotocol/sdk": "^1.27.1",
49
+ "better-sqlite3": "^12.6.2",
50
+ "express": "^5.2.1",
51
+ "yaml": "^2.8.2",
52
+ "zod": "^4.3.6"
53
+ }
54
+ }