cc-agentic-framework 1.14.1

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 (1097) hide show
  1. package/README.md +686 -0
  2. package/bin/agentic-framework +2 -0
  3. package/bin/mcp-server +14 -0
  4. package/dist/__mocks__/chalk.d.ts +11 -0
  5. package/dist/__mocks__/chalk.d.ts.map +1 -0
  6. package/dist/__mocks__/chalk.js +20 -0
  7. package/dist/__mocks__/chalk.js.map +1 -0
  8. package/dist/__mocks__/ora.d.ts +20 -0
  9. package/dist/__mocks__/ora.d.ts.map +1 -0
  10. package/dist/__mocks__/ora.js +52 -0
  11. package/dist/__mocks__/ora.js.map +1 -0
  12. package/dist/commands/add.d.ts +6 -0
  13. package/dist/commands/add.d.ts.map +1 -0
  14. package/dist/commands/add.js +105 -0
  15. package/dist/commands/add.js.map +1 -0
  16. package/dist/commands/agent/index.d.ts +11 -0
  17. package/dist/commands/agent/index.d.ts.map +1 -0
  18. package/dist/commands/agent/index.js +22 -0
  19. package/dist/commands/agent/index.js.map +1 -0
  20. package/dist/commands/agent/list.d.ts +8 -0
  21. package/dist/commands/agent/list.d.ts.map +1 -0
  22. package/dist/commands/agent/list.js +53 -0
  23. package/dist/commands/agent/list.js.map +1 -0
  24. package/dist/commands/agent/run.d.ts +9 -0
  25. package/dist/commands/agent/run.d.ts.map +1 -0
  26. package/dist/commands/agent/run.js +180 -0
  27. package/dist/commands/agent/run.js.map +1 -0
  28. package/dist/commands/agent/show.d.ts +8 -0
  29. package/dist/commands/agent/show.d.ts.map +1 -0
  30. package/dist/commands/agent/show.js +109 -0
  31. package/dist/commands/agent/show.js.map +1 -0
  32. package/dist/commands/backlog/create-ticket.d.ts +19 -0
  33. package/dist/commands/backlog/create-ticket.d.ts.map +1 -0
  34. package/dist/commands/backlog/create-ticket.js +168 -0
  35. package/dist/commands/backlog/create-ticket.js.map +1 -0
  36. package/dist/commands/backlog/import-jira.d.ts +32 -0
  37. package/dist/commands/backlog/import-jira.d.ts.map +1 -0
  38. package/dist/commands/backlog/import-jira.js +126 -0
  39. package/dist/commands/backlog/import-jira.js.map +1 -0
  40. package/dist/commands/backlog/migrate-milestones.d.ts +21 -0
  41. package/dist/commands/backlog/migrate-milestones.d.ts.map +1 -0
  42. package/dist/commands/backlog/migrate-milestones.js +155 -0
  43. package/dist/commands/backlog/migrate-milestones.js.map +1 -0
  44. package/dist/commands/backlog/update-fields.d.ts +36 -0
  45. package/dist/commands/backlog/update-fields.d.ts.map +1 -0
  46. package/dist/commands/backlog/update-fields.js +251 -0
  47. package/dist/commands/backlog/update-fields.js.map +1 -0
  48. package/dist/commands/backlog/validate-enhanced.d.ts +19 -0
  49. package/dist/commands/backlog/validate-enhanced.d.ts.map +1 -0
  50. package/dist/commands/backlog/validate-enhanced.js +282 -0
  51. package/dist/commands/backlog/validate-enhanced.js.map +1 -0
  52. package/dist/commands/backlog/validate.d.ts +19 -0
  53. package/dist/commands/backlog/validate.d.ts.map +1 -0
  54. package/dist/commands/backlog/validate.js +283 -0
  55. package/dist/commands/backlog/validate.js.map +1 -0
  56. package/dist/commands/build.d.ts +20 -0
  57. package/dist/commands/build.d.ts.map +1 -0
  58. package/dist/commands/build.js +116 -0
  59. package/dist/commands/build.js.map +1 -0
  60. package/dist/commands/bump-version.d.ts +61 -0
  61. package/dist/commands/bump-version.d.ts.map +1 -0
  62. package/dist/commands/bump-version.js +618 -0
  63. package/dist/commands/bump-version.js.map +1 -0
  64. package/dist/commands/confluence/create-page.d.ts +11 -0
  65. package/dist/commands/confluence/create-page.d.ts.map +1 -0
  66. package/dist/commands/confluence/create-page.js +72 -0
  67. package/dist/commands/confluence/create-page.js.map +1 -0
  68. package/dist/commands/confluence/fetch-page.d.ts +11 -0
  69. package/dist/commands/confluence/fetch-page.d.ts.map +1 -0
  70. package/dist/commands/confluence/fetch-page.js +64 -0
  71. package/dist/commands/confluence/fetch-page.js.map +1 -0
  72. package/dist/commands/confluence/import-reports.d.ts +12 -0
  73. package/dist/commands/confluence/import-reports.d.ts.map +1 -0
  74. package/dist/commands/confluence/import-reports.js +68 -0
  75. package/dist/commands/confluence/import-reports.js.map +1 -0
  76. package/dist/commands/confluence/validate.d.ts +23 -0
  77. package/dist/commands/confluence/validate.d.ts.map +1 -0
  78. package/dist/commands/confluence/validate.js +272 -0
  79. package/dist/commands/confluence/validate.js.map +1 -0
  80. package/dist/commands/create-agent.d.ts +8 -0
  81. package/dist/commands/create-agent.d.ts.map +1 -0
  82. package/dist/commands/create-agent.js +104 -0
  83. package/dist/commands/create-agent.js.map +1 -0
  84. package/dist/commands/create-module.d.ts +8 -0
  85. package/dist/commands/create-module.d.ts.map +1 -0
  86. package/dist/commands/create-module.js +123 -0
  87. package/dist/commands/create-module.js.map +1 -0
  88. package/dist/commands/create-skill.d.ts +8 -0
  89. package/dist/commands/create-skill.d.ts.map +1 -0
  90. package/dist/commands/create-skill.js +108 -0
  91. package/dist/commands/create-skill.js.map +1 -0
  92. package/dist/commands/dev.d.ts +21 -0
  93. package/dist/commands/dev.d.ts.map +1 -0
  94. package/dist/commands/dev.js +304 -0
  95. package/dist/commands/dev.js.map +1 -0
  96. package/dist/commands/generate-agents.d.ts +19 -0
  97. package/dist/commands/generate-agents.d.ts.map +1 -0
  98. package/dist/commands/generate-agents.js +146 -0
  99. package/dist/commands/generate-agents.js.map +1 -0
  100. package/dist/commands/generate-commands.d.ts +13 -0
  101. package/dist/commands/generate-commands.d.ts.map +1 -0
  102. package/dist/commands/generate-commands.js +229 -0
  103. package/dist/commands/generate-commands.js.map +1 -0
  104. package/dist/commands/info.d.ts +2 -0
  105. package/dist/commands/info.d.ts.map +1 -0
  106. package/dist/commands/info.js +83 -0
  107. package/dist/commands/info.js.map +1 -0
  108. package/dist/commands/init.d.ts +27 -0
  109. package/dist/commands/init.d.ts.map +1 -0
  110. package/dist/commands/init.js +740 -0
  111. package/dist/commands/init.js.map +1 -0
  112. package/dist/commands/jira/export.d.ts +19 -0
  113. package/dist/commands/jira/export.d.ts.map +1 -0
  114. package/dist/commands/jira/export.js +212 -0
  115. package/dist/commands/jira/export.js.map +1 -0
  116. package/dist/commands/jira/sync.d.ts +20 -0
  117. package/dist/commands/jira/sync.d.ts.map +1 -0
  118. package/dist/commands/jira/sync.js +242 -0
  119. package/dist/commands/jira/sync.js.map +1 -0
  120. package/dist/commands/list.d.ts +6 -0
  121. package/dist/commands/list.d.ts.map +1 -0
  122. package/dist/commands/list.js +51 -0
  123. package/dist/commands/list.js.map +1 -0
  124. package/dist/commands/mcp/check.d.ts +11 -0
  125. package/dist/commands/mcp/check.d.ts.map +1 -0
  126. package/dist/commands/mcp/check.js +71 -0
  127. package/dist/commands/mcp/check.js.map +1 -0
  128. package/dist/commands/mcp/index.d.ts +15 -0
  129. package/dist/commands/mcp/index.d.ts.map +1 -0
  130. package/dist/commands/mcp/index.js +28 -0
  131. package/dist/commands/mcp/index.js.map +1 -0
  132. package/dist/commands/mcp/seed.d.ts +11 -0
  133. package/dist/commands/mcp/seed.d.ts.map +1 -0
  134. package/dist/commands/mcp/seed.js +222 -0
  135. package/dist/commands/mcp/seed.js.map +1 -0
  136. package/dist/commands/mcp/setup.d.ts +13 -0
  137. package/dist/commands/mcp/setup.d.ts.map +1 -0
  138. package/dist/commands/mcp/setup.js +387 -0
  139. package/dist/commands/mcp/setup.js.map +1 -0
  140. package/dist/commands/mcp/status.d.ts +11 -0
  141. package/dist/commands/mcp/status.d.ts.map +1 -0
  142. package/dist/commands/mcp/status.js +126 -0
  143. package/dist/commands/mcp/status.js.map +1 -0
  144. package/dist/commands/openclaw/export.d.ts +9 -0
  145. package/dist/commands/openclaw/export.d.ts.map +1 -0
  146. package/dist/commands/openclaw/export.js +72 -0
  147. package/dist/commands/openclaw/export.js.map +1 -0
  148. package/dist/commands/openclaw/index.d.ts +6 -0
  149. package/dist/commands/openclaw/index.d.ts.map +1 -0
  150. package/dist/commands/openclaw/index.js +11 -0
  151. package/dist/commands/openclaw/index.js.map +1 -0
  152. package/dist/commands/planning/create-plan.d.ts +21 -0
  153. package/dist/commands/planning/create-plan.d.ts.map +1 -0
  154. package/dist/commands/planning/create-plan.js +74 -0
  155. package/dist/commands/planning/create-plan.js.map +1 -0
  156. package/dist/commands/planning/validate-plan.d.ts +19 -0
  157. package/dist/commands/planning/validate-plan.d.ts.map +1 -0
  158. package/dist/commands/planning/validate-plan.js +276 -0
  159. package/dist/commands/planning/validate-plan.js.map +1 -0
  160. package/dist/commands/remove.d.ts +8 -0
  161. package/dist/commands/remove.d.ts.map +1 -0
  162. package/dist/commands/remove.js +157 -0
  163. package/dist/commands/remove.js.map +1 -0
  164. package/dist/commands/routes.d.ts +16 -0
  165. package/dist/commands/routes.d.ts.map +1 -0
  166. package/dist/commands/routes.js +153 -0
  167. package/dist/commands/routes.js.map +1 -0
  168. package/dist/commands/skill/deploy.d.ts +12 -0
  169. package/dist/commands/skill/deploy.d.ts.map +1 -0
  170. package/dist/commands/skill/deploy.js +327 -0
  171. package/dist/commands/skill/deploy.js.map +1 -0
  172. package/dist/commands/skill/index.d.ts +6 -0
  173. package/dist/commands/skill/index.d.ts.map +1 -0
  174. package/dist/commands/skill/index.js +20 -0
  175. package/dist/commands/skill/index.js.map +1 -0
  176. package/dist/commands/skill/info.d.ts +11 -0
  177. package/dist/commands/skill/info.d.ts.map +1 -0
  178. package/dist/commands/skill/info.js +260 -0
  179. package/dist/commands/skill/info.js.map +1 -0
  180. package/dist/commands/skill/list.d.ts +11 -0
  181. package/dist/commands/skill/list.d.ts.map +1 -0
  182. package/dist/commands/skill/list.js +242 -0
  183. package/dist/commands/skill/list.js.map +1 -0
  184. package/dist/commands/skill/pull.d.ts +12 -0
  185. package/dist/commands/skill/pull.d.ts.map +1 -0
  186. package/dist/commands/skill/pull.js +133 -0
  187. package/dist/commands/skill/pull.js.map +1 -0
  188. package/dist/commands/skill/remove.d.ts +12 -0
  189. package/dist/commands/skill/remove.d.ts.map +1 -0
  190. package/dist/commands/skill/remove.js +99 -0
  191. package/dist/commands/skill/remove.js.map +1 -0
  192. package/dist/commands/status.d.ts +11 -0
  193. package/dist/commands/status.d.ts.map +1 -0
  194. package/dist/commands/status.js +195 -0
  195. package/dist/commands/status.js.map +1 -0
  196. package/dist/commands/sync.d.ts +20 -0
  197. package/dist/commands/sync.d.ts.map +1 -0
  198. package/dist/commands/sync.js +517 -0
  199. package/dist/commands/sync.js.map +1 -0
  200. package/dist/commands/template/index.d.ts +12 -0
  201. package/dist/commands/template/index.d.ts.map +1 -0
  202. package/dist/commands/template/index.js +24 -0
  203. package/dist/commands/template/index.js.map +1 -0
  204. package/dist/commands/template/info.d.ts +8 -0
  205. package/dist/commands/template/info.d.ts.map +1 -0
  206. package/dist/commands/template/info.js +125 -0
  207. package/dist/commands/template/info.js.map +1 -0
  208. package/dist/commands/template/list.d.ts +8 -0
  209. package/dist/commands/template/list.d.ts.map +1 -0
  210. package/dist/commands/template/list.js +77 -0
  211. package/dist/commands/template/list.js.map +1 -0
  212. package/dist/commands/template/render.d.ts +8 -0
  213. package/dist/commands/template/render.d.ts.map +1 -0
  214. package/dist/commands/template/render.js +115 -0
  215. package/dist/commands/template/render.js.map +1 -0
  216. package/dist/commands/template/validate.d.ts +8 -0
  217. package/dist/commands/template/validate.d.ts.map +1 -0
  218. package/dist/commands/template/validate.js +137 -0
  219. package/dist/commands/template/validate.js.map +1 -0
  220. package/dist/commands/test.d.ts +40 -0
  221. package/dist/commands/test.d.ts.map +1 -0
  222. package/dist/commands/test.js +240 -0
  223. package/dist/commands/test.js.map +1 -0
  224. package/dist/commands/update.d.ts +12 -0
  225. package/dist/commands/update.d.ts.map +1 -0
  226. package/dist/commands/update.js +248 -0
  227. package/dist/commands/update.js.map +1 -0
  228. package/dist/commands/validate.d.ts +12 -0
  229. package/dist/commands/validate.d.ts.map +1 -0
  230. package/dist/commands/validate.js +355 -0
  231. package/dist/commands/validate.js.map +1 -0
  232. package/dist/commands/writer/analyze.d.ts +19 -0
  233. package/dist/commands/writer/analyze.d.ts.map +1 -0
  234. package/dist/commands/writer/analyze.js +210 -0
  235. package/dist/commands/writer/analyze.js.map +1 -0
  236. package/dist/commands/writer/build.d.ts +21 -0
  237. package/dist/commands/writer/build.d.ts.map +1 -0
  238. package/dist/commands/writer/build.js +241 -0
  239. package/dist/commands/writer/build.js.map +1 -0
  240. package/dist/commands/writer/create-chapter.d.ts +19 -0
  241. package/dist/commands/writer/create-chapter.d.ts.map +1 -0
  242. package/dist/commands/writer/create-chapter.js +260 -0
  243. package/dist/commands/writer/create-chapter.js.map +1 -0
  244. package/dist/commands/writer/create-character.d.ts +19 -0
  245. package/dist/commands/writer/create-character.d.ts.map +1 -0
  246. package/dist/commands/writer/create-character.js +263 -0
  247. package/dist/commands/writer/create-character.js.map +1 -0
  248. package/dist/commands/writer/create-part.d.ts +19 -0
  249. package/dist/commands/writer/create-part.d.ts.map +1 -0
  250. package/dist/commands/writer/create-part.js +239 -0
  251. package/dist/commands/writer/create-part.js.map +1 -0
  252. package/dist/commands/writer/create-scene.d.ts +19 -0
  253. package/dist/commands/writer/create-scene.d.ts.map +1 -0
  254. package/dist/commands/writer/create-scene.js +286 -0
  255. package/dist/commands/writer/create-scene.js.map +1 -0
  256. package/dist/commands/writer/export.d.ts +21 -0
  257. package/dist/commands/writer/export.d.ts.map +1 -0
  258. package/dist/commands/writer/export.js +230 -0
  259. package/dist/commands/writer/export.js.map +1 -0
  260. package/dist/commands/writer/init.d.ts +19 -0
  261. package/dist/commands/writer/init.d.ts.map +1 -0
  262. package/dist/commands/writer/init.js +227 -0
  263. package/dist/commands/writer/init.js.map +1 -0
  264. package/dist/commands/writer/lib/immutability-utils.d.ts +82 -0
  265. package/dist/commands/writer/lib/immutability-utils.d.ts.map +1 -0
  266. package/dist/commands/writer/lib/immutability-utils.js +253 -0
  267. package/dist/commands/writer/lib/immutability-utils.js.map +1 -0
  268. package/dist/commands/writer/lib/lock-utils.d.ts +48 -0
  269. package/dist/commands/writer/lib/lock-utils.d.ts.map +1 -0
  270. package/dist/commands/writer/lib/lock-utils.js +122 -0
  271. package/dist/commands/writer/lib/lock-utils.js.map +1 -0
  272. package/dist/commands/writer/lock-fact.d.ts +20 -0
  273. package/dist/commands/writer/lock-fact.d.ts.map +1 -0
  274. package/dist/commands/writer/lock-fact.js +174 -0
  275. package/dist/commands/writer/lock-fact.js.map +1 -0
  276. package/dist/commands/writer/unlock-fact.d.ts +20 -0
  277. package/dist/commands/writer/unlock-fact.d.ts.map +1 -0
  278. package/dist/commands/writer/unlock-fact.js +160 -0
  279. package/dist/commands/writer/unlock-fact.js.map +1 -0
  280. package/dist/commands/writer/validate-immutability.d.ts +19 -0
  281. package/dist/commands/writer/validate-immutability.d.ts.map +1 -0
  282. package/dist/commands/writer/validate-immutability.js +148 -0
  283. package/dist/commands/writer/validate-immutability.js.map +1 -0
  284. package/dist/commands/writer/validate.d.ts +20 -0
  285. package/dist/commands/writer/validate.d.ts.map +1 -0
  286. package/dist/commands/writer/validate.js +370 -0
  287. package/dist/commands/writer/validate.js.map +1 -0
  288. package/dist/hooks/claude-folder-protection.d.ts +23 -0
  289. package/dist/hooks/claude-folder-protection.d.ts.map +1 -0
  290. package/dist/hooks/claude-folder-protection.js +98 -0
  291. package/dist/hooks/claude-folder-protection.js.map +1 -0
  292. package/dist/hooks/index.d.ts +24 -0
  293. package/dist/hooks/index.d.ts.map +1 -0
  294. package/dist/hooks/index.js +24 -0
  295. package/dist/hooks/index.js.map +1 -0
  296. package/dist/hooks/post-write-validate.d.ts +14 -0
  297. package/dist/hooks/post-write-validate.d.ts.map +1 -0
  298. package/dist/hooks/post-write-validate.js +142 -0
  299. package/dist/hooks/post-write-validate.js.map +1 -0
  300. package/dist/hooks/pre-commit-skill-reminder.d.ts +21 -0
  301. package/dist/hooks/pre-commit-skill-reminder.d.ts.map +1 -0
  302. package/dist/hooks/pre-commit-skill-reminder.js +142 -0
  303. package/dist/hooks/pre-commit-skill-reminder.js.map +1 -0
  304. package/dist/hooks/pre-write-quality.d.ts +14 -0
  305. package/dist/hooks/pre-write-quality.d.ts.map +1 -0
  306. package/dist/hooks/pre-write-quality.js +114 -0
  307. package/dist/hooks/pre-write-quality.js.map +1 -0
  308. package/dist/hooks/skill-reminder.d.ts +22 -0
  309. package/dist/hooks/skill-reminder.d.ts.map +1 -0
  310. package/dist/hooks/skill-reminder.js +285 -0
  311. package/dist/hooks/skill-reminder.js.map +1 -0
  312. package/dist/hooks/stop-quality-check.d.ts +14 -0
  313. package/dist/hooks/stop-quality-check.d.ts.map +1 -0
  314. package/dist/hooks/stop-quality-check.js +122 -0
  315. package/dist/hooks/stop-quality-check.js.map +1 -0
  316. package/dist/hooks/subagent-context-loader.d.ts +12 -0
  317. package/dist/hooks/subagent-context-loader.d.ts.map +1 -0
  318. package/dist/hooks/subagent-context-loader.js +124 -0
  319. package/dist/hooks/subagent-context-loader.js.map +1 -0
  320. package/dist/hooks/types.d.ts +89 -0
  321. package/dist/hooks/types.d.ts.map +1 -0
  322. package/dist/hooks/types.js +57 -0
  323. package/dist/hooks/types.js.map +1 -0
  324. package/dist/index.d.ts +3 -0
  325. package/dist/index.d.ts.map +1 -0
  326. package/dist/index.js +256 -0
  327. package/dist/index.js.map +1 -0
  328. package/dist/lib/affected-modules.d.ts +104 -0
  329. package/dist/lib/affected-modules.d.ts.map +1 -0
  330. package/dist/lib/affected-modules.js +283 -0
  331. package/dist/lib/affected-modules.js.map +1 -0
  332. package/dist/lib/agent-generator.d.ts +137 -0
  333. package/dist/lib/agent-generator.d.ts.map +1 -0
  334. package/dist/lib/agent-generator.js +274 -0
  335. package/dist/lib/agent-generator.js.map +1 -0
  336. package/dist/lib/backlog/__mocks__/prompt-utils.d.ts +5 -0
  337. package/dist/lib/backlog/__mocks__/prompt-utils.d.ts.map +1 -0
  338. package/dist/lib/backlog/__mocks__/prompt-utils.js +5 -0
  339. package/dist/lib/backlog/__mocks__/prompt-utils.js.map +1 -0
  340. package/dist/lib/backlog/content-parser.d.ts +83 -0
  341. package/dist/lib/backlog/content-parser.d.ts.map +1 -0
  342. package/dist/lib/backlog/content-parser.js +284 -0
  343. package/dist/lib/backlog/content-parser.js.map +1 -0
  344. package/dist/lib/backlog/csv-extractor.d.ts +87 -0
  345. package/dist/lib/backlog/csv-extractor.d.ts.map +1 -0
  346. package/dist/lib/backlog/csv-extractor.js +338 -0
  347. package/dist/lib/backlog/csv-extractor.js.map +1 -0
  348. package/dist/lib/backlog/epic-handler.d.ts +55 -0
  349. package/dist/lib/backlog/epic-handler.d.ts.map +1 -0
  350. package/dist/lib/backlog/epic-handler.js +222 -0
  351. package/dist/lib/backlog/epic-handler.js.map +1 -0
  352. package/dist/lib/backlog/field-updater.d.ts +195 -0
  353. package/dist/lib/backlog/field-updater.d.ts.map +1 -0
  354. package/dist/lib/backlog/field-updater.js +287 -0
  355. package/dist/lib/backlog/field-updater.js.map +1 -0
  356. package/dist/lib/backlog/import-engine.d.ts +110 -0
  357. package/dist/lib/backlog/import-engine.d.ts.map +1 -0
  358. package/dist/lib/backlog/import-engine.js +241 -0
  359. package/dist/lib/backlog/import-engine.js.map +1 -0
  360. package/dist/lib/backlog/import-strategies.d.ts +110 -0
  361. package/dist/lib/backlog/import-strategies.d.ts.map +1 -0
  362. package/dist/lib/backlog/import-strategies.js +398 -0
  363. package/dist/lib/backlog/import-strategies.js.map +1 -0
  364. package/dist/lib/backlog/jira-file-generators.d.ts +154 -0
  365. package/dist/lib/backlog/jira-file-generators.d.ts.map +1 -0
  366. package/dist/lib/backlog/jira-file-generators.js +265 -0
  367. package/dist/lib/backlog/jira-file-generators.js.map +1 -0
  368. package/dist/lib/backlog/jira-import-workflows.d.ts +112 -0
  369. package/dist/lib/backlog/jira-import-workflows.d.ts.map +1 -0
  370. package/dist/lib/backlog/jira-import-workflows.js +339 -0
  371. package/dist/lib/backlog/jira-import-workflows.js.map +1 -0
  372. package/dist/lib/backlog/jira-lookup.d.ts +121 -0
  373. package/dist/lib/backlog/jira-lookup.d.ts.map +1 -0
  374. package/dist/lib/backlog/jira-lookup.js +232 -0
  375. package/dist/lib/backlog/jira-lookup.js.map +1 -0
  376. package/dist/lib/backlog/jira-prompts.d.ts +66 -0
  377. package/dist/lib/backlog/jira-prompts.d.ts.map +1 -0
  378. package/dist/lib/backlog/jira-prompts.js +232 -0
  379. package/dist/lib/backlog/jira-prompts.js.map +1 -0
  380. package/dist/lib/backlog/jira-validators.d.ts +123 -0
  381. package/dist/lib/backlog/jira-validators.d.ts.map +1 -0
  382. package/dist/lib/backlog/jira-validators.js +394 -0
  383. package/dist/lib/backlog/jira-validators.js.map +1 -0
  384. package/dist/lib/backlog/milestone-generator.d.ts +172 -0
  385. package/dist/lib/backlog/milestone-generator.d.ts.map +1 -0
  386. package/dist/lib/backlog/milestone-generator.js +378 -0
  387. package/dist/lib/backlog/milestone-generator.js.map +1 -0
  388. package/dist/lib/backlog/milestone-migrator.d.ts +174 -0
  389. package/dist/lib/backlog/milestone-migrator.d.ts.map +1 -0
  390. package/dist/lib/backlog/milestone-migrator.js +401 -0
  391. package/dist/lib/backlog/milestone-migrator.js.map +1 -0
  392. package/dist/lib/backlog/milestone-sanitizer.d.ts +72 -0
  393. package/dist/lib/backlog/milestone-sanitizer.d.ts.map +1 -0
  394. package/dist/lib/backlog/milestone-sanitizer.js +139 -0
  395. package/dist/lib/backlog/milestone-sanitizer.js.map +1 -0
  396. package/dist/lib/backlog/prompt-utils.d.ts +9 -0
  397. package/dist/lib/backlog/prompt-utils.d.ts.map +1 -0
  398. package/dist/lib/backlog/prompt-utils.js +11 -0
  399. package/dist/lib/backlog/prompt-utils.js.map +1 -0
  400. package/dist/lib/backlog/sprint-creator.d.ts +145 -0
  401. package/dist/lib/backlog/sprint-creator.d.ts.map +1 -0
  402. package/dist/lib/backlog/sprint-creator.js +295 -0
  403. package/dist/lib/backlog/sprint-creator.js.map +1 -0
  404. package/dist/lib/backlog/ticket-generator.d.ts +79 -0
  405. package/dist/lib/backlog/ticket-generator.d.ts.map +1 -0
  406. package/dist/lib/backlog/ticket-generator.js +281 -0
  407. package/dist/lib/backlog/ticket-generator.js.map +1 -0
  408. package/dist/lib/backlog/ticket-processor.d.ts +205 -0
  409. package/dist/lib/backlog/ticket-processor.d.ts.map +1 -0
  410. package/dist/lib/backlog/ticket-processor.js +422 -0
  411. package/dist/lib/backlog/ticket-processor.js.map +1 -0
  412. package/dist/lib/backlog/types.d.ts +37 -0
  413. package/dist/lib/backlog/types.d.ts.map +1 -0
  414. package/dist/lib/backlog/types.js +7 -0
  415. package/dist/lib/backlog/types.js.map +1 -0
  416. package/dist/lib/backlog/validator.d.ts +61 -0
  417. package/dist/lib/backlog/validator.d.ts.map +1 -0
  418. package/dist/lib/backlog/validator.js +285 -0
  419. package/dist/lib/backlog/validator.js.map +1 -0
  420. package/dist/lib/boundary-validator.d.ts +88 -0
  421. package/dist/lib/boundary-validator.d.ts.map +1 -0
  422. package/dist/lib/boundary-validator.js +494 -0
  423. package/dist/lib/boundary-validator.js.map +1 -0
  424. package/dist/lib/build/build-engine.d.ts +142 -0
  425. package/dist/lib/build/build-engine.d.ts.map +1 -0
  426. package/dist/lib/build/build-engine.js +487 -0
  427. package/dist/lib/build/build-engine.js.map +1 -0
  428. package/dist/lib/build/index.d.ts +7 -0
  429. package/dist/lib/build/index.d.ts.map +1 -0
  430. package/dist/lib/build/index.js +7 -0
  431. package/dist/lib/build/index.js.map +1 -0
  432. package/dist/lib/cleanup-engine.d.ts +121 -0
  433. package/dist/lib/cleanup-engine.d.ts.map +1 -0
  434. package/dist/lib/cleanup-engine.js +252 -0
  435. package/dist/lib/cleanup-engine.js.map +1 -0
  436. package/dist/lib/cli-context.d.ts +283 -0
  437. package/dist/lib/cli-context.d.ts.map +1 -0
  438. package/dist/lib/cli-context.js +403 -0
  439. package/dist/lib/cli-context.js.map +1 -0
  440. package/dist/lib/cli-version.d.ts +7 -0
  441. package/dist/lib/cli-version.d.ts.map +1 -0
  442. package/dist/lib/cli-version.js +30 -0
  443. package/dist/lib/cli-version.js.map +1 -0
  444. package/dist/lib/command-factory.d.ts +76 -0
  445. package/dist/lib/command-factory.d.ts.map +1 -0
  446. package/dist/lib/command-factory.js +166 -0
  447. package/dist/lib/command-factory.js.map +1 -0
  448. package/dist/lib/common/api-client.d.ts +92 -0
  449. package/dist/lib/common/api-client.d.ts.map +1 -0
  450. package/dist/lib/common/api-client.js +206 -0
  451. package/dist/lib/common/api-client.js.map +1 -0
  452. package/dist/lib/common/file-utils.d.ts +92 -0
  453. package/dist/lib/common/file-utils.d.ts.map +1 -0
  454. package/dist/lib/common/file-utils.js +143 -0
  455. package/dist/lib/common/file-utils.js.map +1 -0
  456. package/dist/lib/common/validation.d.ts +91 -0
  457. package/dist/lib/common/validation.d.ts.map +1 -0
  458. package/dist/lib/common/validation.js +213 -0
  459. package/dist/lib/common/validation.js.map +1 -0
  460. package/dist/lib/common/yaml-frontmatter.d.ts +76 -0
  461. package/dist/lib/common/yaml-frontmatter.d.ts.map +1 -0
  462. package/dist/lib/common/yaml-frontmatter.js +89 -0
  463. package/dist/lib/common/yaml-frontmatter.js.map +1 -0
  464. package/dist/lib/confluence/adf-converter.d.ts +30 -0
  465. package/dist/lib/confluence/adf-converter.d.ts.map +1 -0
  466. package/dist/lib/confluence/adf-converter.js +649 -0
  467. package/dist/lib/confluence/adf-converter.js.map +1 -0
  468. package/dist/lib/confluence/confluence-client.d.ts +121 -0
  469. package/dist/lib/confluence/confluence-client.d.ts.map +1 -0
  470. package/dist/lib/confluence/confluence-client.js +249 -0
  471. package/dist/lib/confluence/confluence-client.js.map +1 -0
  472. package/dist/lib/confluence/confluence-commands.d.ts +58 -0
  473. package/dist/lib/confluence/confluence-commands.d.ts.map +1 -0
  474. package/dist/lib/confluence/confluence-commands.js +231 -0
  475. package/dist/lib/confluence/confluence-commands.js.map +1 -0
  476. package/dist/lib/discovery-engine.d.ts +159 -0
  477. package/dist/lib/discovery-engine.d.ts.map +1 -0
  478. package/dist/lib/discovery-engine.js +538 -0
  479. package/dist/lib/discovery-engine.js.map +1 -0
  480. package/dist/lib/framework-validator.d.ts +81 -0
  481. package/dist/lib/framework-validator.d.ts.map +1 -0
  482. package/dist/lib/framework-validator.js +546 -0
  483. package/dist/lib/framework-validator.js.map +1 -0
  484. package/dist/lib/global-skills-manager.d.ts +90 -0
  485. package/dist/lib/global-skills-manager.d.ts.map +1 -0
  486. package/dist/lib/global-skills-manager.js +180 -0
  487. package/dist/lib/global-skills-manager.js.map +1 -0
  488. package/dist/lib/jira/acceptance-criteria.d.ts +76 -0
  489. package/dist/lib/jira/acceptance-criteria.d.ts.map +1 -0
  490. package/dist/lib/jira/acceptance-criteria.js +163 -0
  491. package/dist/lib/jira/acceptance-criteria.js.map +1 -0
  492. package/dist/lib/jira/export-engine.d.ts +132 -0
  493. package/dist/lib/jira/export-engine.d.ts.map +1 -0
  494. package/dist/lib/jira/export-engine.js +332 -0
  495. package/dist/lib/jira/export-engine.js.map +1 -0
  496. package/dist/lib/jira/field-mapper.d.ts +101 -0
  497. package/dist/lib/jira/field-mapper.d.ts.map +1 -0
  498. package/dist/lib/jira/field-mapper.js +346 -0
  499. package/dist/lib/jira/field-mapper.js.map +1 -0
  500. package/dist/lib/jira/jira-client.d.ts +117 -0
  501. package/dist/lib/jira/jira-client.d.ts.map +1 -0
  502. package/dist/lib/jira/jira-client.js +255 -0
  503. package/dist/lib/jira/jira-client.js.map +1 -0
  504. package/dist/lib/jira/sync-engine.d.ts +154 -0
  505. package/dist/lib/jira/sync-engine.d.ts.map +1 -0
  506. package/dist/lib/jira/sync-engine.js +420 -0
  507. package/dist/lib/jira/sync-engine.js.map +1 -0
  508. package/dist/lib/jira/wiki-converter.d.ts +133 -0
  509. package/dist/lib/jira/wiki-converter.d.ts.map +1 -0
  510. package/dist/lib/jira/wiki-converter.js +245 -0
  511. package/dist/lib/jira/wiki-converter.js.map +1 -0
  512. package/dist/lib/link-transformer.d.ts +176 -0
  513. package/dist/lib/link-transformer.d.ts.map +1 -0
  514. package/dist/lib/link-transformer.js +349 -0
  515. package/dist/lib/link-transformer.js.map +1 -0
  516. package/dist/lib/link-validator.d.ts +232 -0
  517. package/dist/lib/link-validator.d.ts.map +1 -0
  518. package/dist/lib/link-validator.js +504 -0
  519. package/dist/lib/link-validator.js.map +1 -0
  520. package/dist/lib/manifest-manager.d.ts +112 -0
  521. package/dist/lib/manifest-manager.d.ts.map +1 -0
  522. package/dist/lib/manifest-manager.js +153 -0
  523. package/dist/lib/manifest-manager.js.map +1 -0
  524. package/dist/lib/mcp/extractors/framework-project.d.ts +29 -0
  525. package/dist/lib/mcp/extractors/framework-project.d.ts.map +1 -0
  526. package/dist/lib/mcp/extractors/framework-project.js +402 -0
  527. package/dist/lib/mcp/extractors/framework-project.js.map +1 -0
  528. package/dist/lib/mcp/extractors/generic-project.d.ts +25 -0
  529. package/dist/lib/mcp/extractors/generic-project.d.ts.map +1 -0
  530. package/dist/lib/mcp/extractors/generic-project.js +344 -0
  531. package/dist/lib/mcp/extractors/generic-project.js.map +1 -0
  532. package/dist/lib/mcp/extractors/index.d.ts +48 -0
  533. package/dist/lib/mcp/extractors/index.d.ts.map +1 -0
  534. package/dist/lib/mcp/extractors/index.js +28 -0
  535. package/dist/lib/mcp/extractors/index.js.map +1 -0
  536. package/dist/lib/mcp/index.d.ts +11 -0
  537. package/dist/lib/mcp/index.d.ts.map +1 -0
  538. package/dist/lib/mcp/index.js +11 -0
  539. package/dist/lib/mcp/index.js.map +1 -0
  540. package/dist/lib/mcp/install-instructions.d.ts +39 -0
  541. package/dist/lib/mcp/install-instructions.d.ts.map +1 -0
  542. package/dist/lib/mcp/install-instructions.js +317 -0
  543. package/dist/lib/mcp/install-instructions.js.map +1 -0
  544. package/dist/lib/mcp/prerequisite-checker.d.ts +79 -0
  545. package/dist/lib/mcp/prerequisite-checker.d.ts.map +1 -0
  546. package/dist/lib/mcp/prerequisite-checker.js +213 -0
  547. package/dist/lib/mcp/prerequisite-checker.js.map +1 -0
  548. package/dist/lib/module-loader.d.ts +77 -0
  549. package/dist/lib/module-loader.d.ts.map +1 -0
  550. package/dist/lib/module-loader.js +135 -0
  551. package/dist/lib/module-loader.js.map +1 -0
  552. package/dist/lib/path-resolver.d.ts +160 -0
  553. package/dist/lib/path-resolver.d.ts.map +1 -0
  554. package/dist/lib/path-resolver.js +205 -0
  555. package/dist/lib/path-resolver.js.map +1 -0
  556. package/dist/lib/planning/plan-creator.d.ts +132 -0
  557. package/dist/lib/planning/plan-creator.d.ts.map +1 -0
  558. package/dist/lib/planning/plan-creator.js +361 -0
  559. package/dist/lib/planning/plan-creator.js.map +1 -0
  560. package/dist/lib/project-resolver.d.ts +124 -0
  561. package/dist/lib/project-resolver.d.ts.map +1 -0
  562. package/dist/lib/project-resolver.js +362 -0
  563. package/dist/lib/project-resolver.js.map +1 -0
  564. package/dist/lib/registry-generator.d.ts +11 -0
  565. package/dist/lib/registry-generator.d.ts.map +1 -0
  566. package/dist/lib/registry-generator.js +288 -0
  567. package/dist/lib/registry-generator.js.map +1 -0
  568. package/dist/lib/routes-validator.d.ts +50 -0
  569. package/dist/lib/routes-validator.d.ts.map +1 -0
  570. package/dist/lib/routes-validator.js +260 -0
  571. package/dist/lib/routes-validator.js.map +1 -0
  572. package/dist/lib/schemas/agent.schema.d.ts +175 -0
  573. package/dist/lib/schemas/agent.schema.d.ts.map +1 -0
  574. package/dist/lib/schemas/agent.schema.js +86 -0
  575. package/dist/lib/schemas/agent.schema.js.map +1 -0
  576. package/dist/lib/schemas/index.d.ts +13 -0
  577. package/dist/lib/schemas/index.d.ts.map +1 -0
  578. package/dist/lib/schemas/index.js +13 -0
  579. package/dist/lib/schemas/index.js.map +1 -0
  580. package/dist/lib/schemas/skill.schema.d.ts +92 -0
  581. package/dist/lib/schemas/skill.schema.d.ts.map +1 -0
  582. package/dist/lib/schemas/skill.schema.js +98 -0
  583. package/dist/lib/schemas/skill.schema.js.map +1 -0
  584. package/dist/lib/sdk/executor.d.ts +37 -0
  585. package/dist/lib/sdk/executor.d.ts.map +1 -0
  586. package/dist/lib/sdk/executor.js +137 -0
  587. package/dist/lib/sdk/executor.js.map +1 -0
  588. package/dist/lib/sdk/generator.d.ts +79 -0
  589. package/dist/lib/sdk/generator.d.ts.map +1 -0
  590. package/dist/lib/sdk/generator.js +316 -0
  591. package/dist/lib/sdk/generator.js.map +1 -0
  592. package/dist/lib/sdk/index.d.ts +12 -0
  593. package/dist/lib/sdk/index.d.ts.map +1 -0
  594. package/dist/lib/sdk/index.js +15 -0
  595. package/dist/lib/sdk/index.js.map +1 -0
  596. package/dist/lib/sdk/message-handler.d.ts +40 -0
  597. package/dist/lib/sdk/message-handler.d.ts.map +1 -0
  598. package/dist/lib/sdk/message-handler.js +215 -0
  599. package/dist/lib/sdk/message-handler.js.map +1 -0
  600. package/dist/lib/sdk/sub-agents.d.ts +51 -0
  601. package/dist/lib/sdk/sub-agents.d.ts.map +1 -0
  602. package/dist/lib/sdk/sub-agents.js +234 -0
  603. package/dist/lib/sdk/sub-agents.js.map +1 -0
  604. package/dist/lib/sdk/types.d.ts +169 -0
  605. package/dist/lib/sdk/types.d.ts.map +1 -0
  606. package/dist/lib/sdk/types.js +7 -0
  607. package/dist/lib/sdk/types.js.map +1 -0
  608. package/dist/lib/skill-cli-parser.d.ts +79 -0
  609. package/dist/lib/skill-cli-parser.d.ts.map +1 -0
  610. package/dist/lib/skill-cli-parser.js +172 -0
  611. package/dist/lib/skill-cli-parser.js.map +1 -0
  612. package/dist/lib/skill-template-engine.d.ts +116 -0
  613. package/dist/lib/skill-template-engine.d.ts.map +1 -0
  614. package/dist/lib/skill-template-engine.js +220 -0
  615. package/dist/lib/skill-template-engine.js.map +1 -0
  616. package/dist/lib/sync-engine.d.ts +344 -0
  617. package/dist/lib/sync-engine.d.ts.map +1 -0
  618. package/dist/lib/sync-engine.js +1255 -0
  619. package/dist/lib/sync-engine.js.map +1 -0
  620. package/dist/lib/telemetry/config.d.ts +22 -0
  621. package/dist/lib/telemetry/config.d.ts.map +1 -0
  622. package/dist/lib/telemetry/config.js +210 -0
  623. package/dist/lib/telemetry/config.js.map +1 -0
  624. package/dist/lib/telemetry/exporters/console-exporter.d.ts +72 -0
  625. package/dist/lib/telemetry/exporters/console-exporter.d.ts.map +1 -0
  626. package/dist/lib/telemetry/exporters/console-exporter.js +228 -0
  627. package/dist/lib/telemetry/exporters/console-exporter.js.map +1 -0
  628. package/dist/lib/telemetry/exporters/json-file-exporter.d.ts +48 -0
  629. package/dist/lib/telemetry/exporters/json-file-exporter.d.ts.map +1 -0
  630. package/dist/lib/telemetry/exporters/json-file-exporter.js +202 -0
  631. package/dist/lib/telemetry/exporters/json-file-exporter.js.map +1 -0
  632. package/dist/lib/telemetry/exporters/otel-exporter.d.ts +48 -0
  633. package/dist/lib/telemetry/exporters/otel-exporter.d.ts.map +1 -0
  634. package/dist/lib/telemetry/exporters/otel-exporter.js +299 -0
  635. package/dist/lib/telemetry/exporters/otel-exporter.js.map +1 -0
  636. package/dist/lib/telemetry/exporters/session-file-exporter.d.ts +66 -0
  637. package/dist/lib/telemetry/exporters/session-file-exporter.d.ts.map +1 -0
  638. package/dist/lib/telemetry/exporters/session-file-exporter.js +223 -0
  639. package/dist/lib/telemetry/exporters/session-file-exporter.js.map +1 -0
  640. package/dist/lib/telemetry/index.d.ts +44 -0
  641. package/dist/lib/telemetry/index.d.ts.map +1 -0
  642. package/dist/lib/telemetry/index.js +69 -0
  643. package/dist/lib/telemetry/index.js.map +1 -0
  644. package/dist/lib/telemetry/instrumentation/cli-instrumentation.d.ts +25 -0
  645. package/dist/lib/telemetry/instrumentation/cli-instrumentation.d.ts.map +1 -0
  646. package/dist/lib/telemetry/instrumentation/cli-instrumentation.js +83 -0
  647. package/dist/lib/telemetry/instrumentation/cli-instrumentation.js.map +1 -0
  648. package/dist/lib/telemetry/instrumentation/discovery-instrumentation.d.ts +21 -0
  649. package/dist/lib/telemetry/instrumentation/discovery-instrumentation.d.ts.map +1 -0
  650. package/dist/lib/telemetry/instrumentation/discovery-instrumentation.js +78 -0
  651. package/dist/lib/telemetry/instrumentation/discovery-instrumentation.js.map +1 -0
  652. package/dist/lib/telemetry/instrumentation/mcp-instrumentation.d.ts +76 -0
  653. package/dist/lib/telemetry/instrumentation/mcp-instrumentation.d.ts.map +1 -0
  654. package/dist/lib/telemetry/instrumentation/mcp-instrumentation.js +168 -0
  655. package/dist/lib/telemetry/instrumentation/mcp-instrumentation.js.map +1 -0
  656. package/dist/lib/telemetry/instrumentation/sync-instrumentation.d.ts +25 -0
  657. package/dist/lib/telemetry/instrumentation/sync-instrumentation.d.ts.map +1 -0
  658. package/dist/lib/telemetry/instrumentation/sync-instrumentation.js +51 -0
  659. package/dist/lib/telemetry/instrumentation/sync-instrumentation.js.map +1 -0
  660. package/dist/lib/telemetry/session-context.d.ts +109 -0
  661. package/dist/lib/telemetry/session-context.d.ts.map +1 -0
  662. package/dist/lib/telemetry/session-context.js +170 -0
  663. package/dist/lib/telemetry/session-context.js.map +1 -0
  664. package/dist/lib/telemetry/telemetry-manager.d.ts +88 -0
  665. package/dist/lib/telemetry/telemetry-manager.d.ts.map +1 -0
  666. package/dist/lib/telemetry/telemetry-manager.js +347 -0
  667. package/dist/lib/telemetry/telemetry-manager.js.map +1 -0
  668. package/dist/lib/telemetry/types.d.ts +302 -0
  669. package/dist/lib/telemetry/types.d.ts.map +1 -0
  670. package/dist/lib/telemetry/types.js +6 -0
  671. package/dist/lib/telemetry/types.js.map +1 -0
  672. package/dist/lib/template-engine.d.ts +5 -0
  673. package/dist/lib/template-engine.d.ts.map +1 -0
  674. package/dist/lib/template-engine.js +294 -0
  675. package/dist/lib/template-engine.js.map +1 -0
  676. package/dist/lib/unified-template-engine/computed-variables.d.ts +38 -0
  677. package/dist/lib/unified-template-engine/computed-variables.d.ts.map +1 -0
  678. package/dist/lib/unified-template-engine/computed-variables.js +85 -0
  679. package/dist/lib/unified-template-engine/computed-variables.js.map +1 -0
  680. package/dist/lib/unified-template-engine/index.d.ts +67 -0
  681. package/dist/lib/unified-template-engine/index.d.ts.map +1 -0
  682. package/dist/lib/unified-template-engine/index.js +200 -0
  683. package/dist/lib/unified-template-engine/index.js.map +1 -0
  684. package/dist/lib/unified-template-engine/resolver.d.ts +63 -0
  685. package/dist/lib/unified-template-engine/resolver.d.ts.map +1 -0
  686. package/dist/lib/unified-template-engine/resolver.js +312 -0
  687. package/dist/lib/unified-template-engine/resolver.js.map +1 -0
  688. package/dist/lib/unified-template-engine/types.d.ts +177 -0
  689. package/dist/lib/unified-template-engine/types.d.ts.map +1 -0
  690. package/dist/lib/unified-template-engine/types.js +7 -0
  691. package/dist/lib/unified-template-engine/types.js.map +1 -0
  692. package/dist/lib/unified-template-engine/validator.d.ts +23 -0
  693. package/dist/lib/unified-template-engine/validator.d.ts.map +1 -0
  694. package/dist/lib/unified-template-engine/validator.js +217 -0
  695. package/dist/lib/unified-template-engine/validator.js.map +1 -0
  696. package/dist/lib/validation/rules/plan-rules.d.ts +48 -0
  697. package/dist/lib/validation/rules/plan-rules.d.ts.map +1 -0
  698. package/dist/lib/validation/rules/plan-rules.js +152 -0
  699. package/dist/lib/validation/rules/plan-rules.js.map +1 -0
  700. package/dist/lib/validation/rules/ticket-rules.d.ts +54 -0
  701. package/dist/lib/validation/rules/ticket-rules.d.ts.map +1 -0
  702. package/dist/lib/validation/rules/ticket-rules.js +136 -0
  703. package/dist/lib/validation/rules/ticket-rules.js.map +1 -0
  704. package/dist/lib/validation/schema-validator.d.ts +26 -0
  705. package/dist/lib/validation/schema-validator.d.ts.map +1 -0
  706. package/dist/lib/validation/schema-validator.js +183 -0
  707. package/dist/lib/validation/schema-validator.js.map +1 -0
  708. package/dist/lib/validation/validation-report.d.ts +68 -0
  709. package/dist/lib/validation/validation-report.d.ts.map +1 -0
  710. package/dist/lib/validation/validation-report.js +141 -0
  711. package/dist/lib/validation/validation-report.js.map +1 -0
  712. package/dist/lib/version-validator.d.ts +89 -0
  713. package/dist/lib/version-validator.d.ts.map +1 -0
  714. package/dist/lib/version-validator.js +178 -0
  715. package/dist/lib/version-validator.js.map +1 -0
  716. package/dist/lib/wizard/detection.d.ts +48 -0
  717. package/dist/lib/wizard/detection.d.ts.map +1 -0
  718. package/dist/lib/wizard/detection.js +116 -0
  719. package/dist/lib/wizard/detection.js.map +1 -0
  720. package/dist/lib/wizard/file-handlers.d.ts +40 -0
  721. package/dist/lib/wizard/file-handlers.d.ts.map +1 -0
  722. package/dist/lib/wizard/file-handlers.js +204 -0
  723. package/dist/lib/wizard/file-handlers.js.map +1 -0
  724. package/dist/lib/wizard/index.d.ts +9 -0
  725. package/dist/lib/wizard/index.d.ts.map +1 -0
  726. package/dist/lib/wizard/index.js +9 -0
  727. package/dist/lib/wizard/index.js.map +1 -0
  728. package/dist/lib/wizard/init-wizard.d.ts +35 -0
  729. package/dist/lib/wizard/init-wizard.d.ts.map +1 -0
  730. package/dist/lib/wizard/init-wizard.js +86 -0
  731. package/dist/lib/wizard/init-wizard.js.map +1 -0
  732. package/dist/lib/wizard/module-groups.d.ts +55 -0
  733. package/dist/lib/wizard/module-groups.d.ts.map +1 -0
  734. package/dist/lib/wizard/module-groups.js +128 -0
  735. package/dist/lib/wizard/module-groups.js.map +1 -0
  736. package/dist/lib/wizard/prompts.d.ts +36 -0
  737. package/dist/lib/wizard/prompts.d.ts.map +1 -0
  738. package/dist/lib/wizard/prompts.js +253 -0
  739. package/dist/lib/wizard/prompts.js.map +1 -0
  740. package/dist/lib/wizard/summary.d.ts +45 -0
  741. package/dist/lib/wizard/summary.d.ts.map +1 -0
  742. package/dist/lib/wizard/summary.js +162 -0
  743. package/dist/lib/wizard/summary.js.map +1 -0
  744. package/dist/mcp/index.d.ts +15 -0
  745. package/dist/mcp/index.d.ts.map +1 -0
  746. package/dist/mcp/index.js +75 -0
  747. package/dist/mcp/index.js.map +1 -0
  748. package/dist/mcp/result-formatter.d.ts +68 -0
  749. package/dist/mcp/result-formatter.d.ts.map +1 -0
  750. package/dist/mcp/result-formatter.js +191 -0
  751. package/dist/mcp/result-formatter.js.map +1 -0
  752. package/dist/mcp/tool-registry.d.ts +70 -0
  753. package/dist/mcp/tool-registry.d.ts.map +1 -0
  754. package/dist/mcp/tool-registry.js +183 -0
  755. package/dist/mcp/tool-registry.js.map +1 -0
  756. package/dist/mcp/tools/agent.d.ts +22 -0
  757. package/dist/mcp/tools/agent.d.ts.map +1 -0
  758. package/dist/mcp/tools/agent.js +267 -0
  759. package/dist/mcp/tools/agent.js.map +1 -0
  760. package/dist/mcp/tools/backlog.d.ts +15 -0
  761. package/dist/mcp/tools/backlog.d.ts.map +1 -0
  762. package/dist/mcp/tools/backlog.js +355 -0
  763. package/dist/mcp/tools/backlog.js.map +1 -0
  764. package/dist/mcp/tools/confluence.d.ts +32 -0
  765. package/dist/mcp/tools/confluence.d.ts.map +1 -0
  766. package/dist/mcp/tools/confluence.js +367 -0
  767. package/dist/mcp/tools/confluence.js.map +1 -0
  768. package/dist/mcp/tools/create.d.ts +22 -0
  769. package/dist/mcp/tools/create.d.ts.map +1 -0
  770. package/dist/mcp/tools/create.js +311 -0
  771. package/dist/mcp/tools/create.js.map +1 -0
  772. package/dist/mcp/tools/framework.d.ts +24 -0
  773. package/dist/mcp/tools/framework.d.ts.map +1 -0
  774. package/dist/mcp/tools/framework.js +430 -0
  775. package/dist/mcp/tools/framework.js.map +1 -0
  776. package/dist/mcp/tools/index.d.ts +32 -0
  777. package/dist/mcp/tools/index.d.ts.map +1 -0
  778. package/dist/mcp/tools/index.js +58 -0
  779. package/dist/mcp/tools/index.js.map +1 -0
  780. package/dist/mcp/tools/jira.d.ts +12 -0
  781. package/dist/mcp/tools/jira.d.ts.map +1 -0
  782. package/dist/mcp/tools/jira.js +206 -0
  783. package/dist/mcp/tools/jira.js.map +1 -0
  784. package/dist/mcp/tools/planning.d.ts +22 -0
  785. package/dist/mcp/tools/planning.d.ts.map +1 -0
  786. package/dist/mcp/tools/planning.js +264 -0
  787. package/dist/mcp/tools/planning.js.map +1 -0
  788. package/dist/mcp/tools/skill.d.ts +42 -0
  789. package/dist/mcp/tools/skill.d.ts.map +1 -0
  790. package/dist/mcp/tools/skill.js +561 -0
  791. package/dist/mcp/tools/skill.js.map +1 -0
  792. package/dist/mcp/tools/template.d.ts +36 -0
  793. package/dist/mcp/tools/template.d.ts.map +1 -0
  794. package/dist/mcp/tools/template.js +354 -0
  795. package/dist/mcp/tools/template.js.map +1 -0
  796. package/dist/mcp/tools/writer.d.ts +23 -0
  797. package/dist/mcp/tools/writer.d.ts.map +1 -0
  798. package/dist/mcp/tools/writer.js +394 -0
  799. package/dist/mcp/tools/writer.js.map +1 -0
  800. package/dist/mcp/types.d.ts +102 -0
  801. package/dist/mcp/types.d.ts.map +1 -0
  802. package/dist/mcp/types.js +37 -0
  803. package/dist/mcp/types.js.map +1 -0
  804. package/dist/templates/index.d.ts +11 -0
  805. package/dist/templates/index.d.ts.map +1 -0
  806. package/dist/templates/index.js +11 -0
  807. package/dist/templates/index.js.map +1 -0
  808. package/dist/templates/mcp-hooks.d.ts +37 -0
  809. package/dist/templates/mcp-hooks.d.ts.map +1 -0
  810. package/dist/templates/mcp-hooks.js +224 -0
  811. package/dist/templates/mcp-hooks.js.map +1 -0
  812. package/dist/templates/serena-project.d.ts +14 -0
  813. package/dist/templates/serena-project.d.ts.map +1 -0
  814. package/dist/templates/serena-project.js +105 -0
  815. package/dist/templates/serena-project.js.map +1 -0
  816. package/dist/templates/settings-json.d.ts +28 -0
  817. package/dist/templates/settings-json.d.ts.map +1 -0
  818. package/dist/templates/settings-json.js +190 -0
  819. package/dist/templates/settings-json.js.map +1 -0
  820. package/dist/templates/settings-local.d.ts +69 -0
  821. package/dist/templates/settings-local.d.ts.map +1 -0
  822. package/dist/templates/settings-local.js +56 -0
  823. package/dist/templates/settings-local.js.map +1 -0
  824. package/dist/templates/statusline.d.ts +7 -0
  825. package/dist/templates/statusline.d.ts.map +1 -0
  826. package/dist/templates/statusline.js +260 -0
  827. package/dist/templates/statusline.js.map +1 -0
  828. package/dist/types/command-options.d.ts +392 -0
  829. package/dist/types/command-options.d.ts.map +1 -0
  830. package/dist/types/command-options.js +15 -0
  831. package/dist/types/command-options.js.map +1 -0
  832. package/framework/modules/backlog/agents/ai-backlog-manager.md +430 -0
  833. package/framework/modules/backlog/commands/cmd-backlog-create-ticket.md +42 -0
  834. package/framework/modules/backlog/commands/cmd-backlog-import.md +42 -0
  835. package/framework/modules/backlog/commands/cmd-backlog-migrate-milestones.md +42 -0
  836. package/framework/modules/backlog/commands/cmd-backlog-update-fields.md +42 -0
  837. package/framework/modules/backlog/commands/cmd-backlog-validate.md +42 -0
  838. package/framework/modules/backlog/module.json +82 -0
  839. package/framework/modules/backlog/schemas/ticket.schema.json +143 -0
  840. package/framework/modules/backlog/skills/backlog/building-tickets/BODY-STRUCTURE.md +470 -0
  841. package/framework/modules/backlog/skills/backlog/building-tickets/EXAMPLES.md +561 -0
  842. package/framework/modules/backlog/skills/backlog/building-tickets/SKILL.md +293 -0
  843. package/framework/modules/backlog/skills/backlog/building-tickets/VALIDATION-RULES.md +748 -0
  844. package/framework/modules/backlog/skills/backlog/building-tickets/YAML-STRUCTURE.md +439 -0
  845. package/framework/modules/backlog/skills/backlog/building-tickets/templates/bug.template.md +83 -0
  846. package/framework/modules/backlog/skills/backlog/building-tickets/templates/epic.template.md +96 -0
  847. package/framework/modules/backlog/skills/backlog/building-tickets/templates/story.template.md +68 -0
  848. package/framework/modules/backlog/skills/backlog/building-tickets/templates/task.template.md +66 -0
  849. package/framework/modules/backlog/skills/backlog/building-tickets/templates/template.config.json +50 -0
  850. package/framework/modules/backlog/skills/backlog/organizing-backlog/DIRECTORY-STRUCTURE.md +195 -0
  851. package/framework/modules/backlog/skills/backlog/organizing-backlog/EXAMPLES.md +374 -0
  852. package/framework/modules/backlog/skills/backlog/organizing-backlog/JIRA-SOURCE-OF-TRUTH.md +384 -0
  853. package/framework/modules/backlog/skills/backlog/organizing-backlog/NAMING-CONVENTIONS.md +230 -0
  854. package/framework/modules/backlog/skills/backlog/organizing-backlog/SKILL.md +332 -0
  855. package/framework/modules/backlog/skills/backlog/organizing-backlog/WORKFLOW-PIPELINE.md +298 -0
  856. package/framework/modules/backlog/templates/ticket.md.template +111 -0
  857. package/framework/modules/coding/agents/ai-app-developer.md +275 -0
  858. package/framework/modules/coding/agents/ai-architect.md +454 -0
  859. package/framework/modules/coding/agents/ai-hig-reviewer.md +69 -0
  860. package/framework/modules/coding/agents/ai-ios-developer.md +303 -0
  861. package/framework/modules/coding/module.json +56 -0
  862. package/framework/modules/coding/skills/coding/designing-architecture/SKILL.md +475 -0
  863. package/framework/modules/coding/skills/coding/designing-ios-ui/SKILL.md +405 -0
  864. package/framework/modules/coding/skills/coding/implementing-code/EXAMPLES.md +565 -0
  865. package/framework/modules/coding/skills/coding/implementing-code/SKILL.md +490 -0
  866. package/framework/modules/coding/skills/coding/implementing-ios/ANTI-PATTERNS.md +564 -0
  867. package/framework/modules/coding/skills/coding/implementing-ios/ARCHITECTURE-PATTERNS.md +539 -0
  868. package/framework/modules/coding/skills/coding/implementing-ios/HIG-COMPLIANCE.md +492 -0
  869. package/framework/modules/coding/skills/coding/implementing-ios/SKILL.md +506 -0
  870. package/framework/modules/coding/skills/coding/implementing-ios/SWIFTUI-PATTERNS.md +625 -0
  871. package/framework/modules/coding/skills/coding/implementing-ios/TESTING-PATTERNS.md +625 -0
  872. package/framework/modules/coding/skills/coding/implementing-ios/UIKIT-PATTERNS.md +470 -0
  873. package/framework/modules/coding/skills/coding/structuring-code/CHECKLISTS.md +151 -0
  874. package/framework/modules/coding/skills/coding/structuring-code/DRY-PRINCIPLES.md +285 -0
  875. package/framework/modules/coding/skills/coding/structuring-code/FILE-ORGANIZATION.md +278 -0
  876. package/framework/modules/coding/skills/coding/structuring-code/READABILITY.md +291 -0
  877. package/framework/modules/coding/skills/coding/structuring-code/SKILL.md +289 -0
  878. package/framework/modules/confluence/agents/ai-confluence-manager.md +369 -0
  879. package/framework/modules/confluence/commands/cmd-confluence-create-page.md +42 -0
  880. package/framework/modules/confluence/commands/cmd-confluence-fetch-page.md +42 -0
  881. package/framework/modules/confluence/commands/cmd-confluence-import-reports.md +42 -0
  882. package/framework/modules/confluence/commands/cmd-confluence-validate.md +42 -0
  883. package/framework/modules/confluence/module.json +69 -0
  884. package/framework/modules/confluence/schemas/adf.schema.json +128 -0
  885. package/framework/modules/confluence/skills/confluence/converting-adf/SKILL.md +455 -0
  886. package/framework/modules/confluence/skills/confluence/publishing-confluence/ADF-EXAMPLES.md +433 -0
  887. package/framework/modules/confluence/skills/confluence/publishing-confluence/EXAMPLES.md +513 -0
  888. package/framework/modules/confluence/skills/confluence/publishing-confluence/SKILL.md +651 -0
  889. package/framework/modules/core/agents/ai-framework-developer.md +184 -0
  890. package/framework/modules/core/agents/ai-framework-manager.md +222 -0
  891. package/framework/modules/core/agents/ai-scout-backlog.md +65 -0
  892. package/framework/modules/core/agents/ai-scout-codebase.md +66 -0
  893. package/framework/modules/core/agents/ai-scout-knowledge.md +63 -0
  894. package/framework/modules/core/commands/cmd-agent-list.md +37 -0
  895. package/framework/modules/core/commands/cmd-agent-run.md +37 -0
  896. package/framework/modules/core/commands/cmd-agent-show.md +37 -0
  897. package/framework/modules/core/commands/cmd-bump-version.md +42 -0
  898. package/framework/modules/core/commands/cmd-mcp-check.md +59 -0
  899. package/framework/modules/core/commands/cmd-mcp-seed.md +69 -0
  900. package/framework/modules/core/commands/cmd-mcp-setup.md +61 -0
  901. package/framework/modules/core/commands/cmd-mcp-status.md +70 -0
  902. package/framework/modules/core/commands/cmd-validate-links.md +42 -0
  903. package/framework/modules/core/commands/cmd-validate-versions.md +42 -0
  904. package/framework/modules/core/hooks/_lib/notify-helper.sh +27 -0
  905. package/framework/modules/core/hooks/block-main-commit.sh +35 -0
  906. package/framework/modules/core/hooks/notify.sh +43 -0
  907. package/framework/modules/core/hooks/post-write-format.sh +52 -0
  908. package/framework/modules/core/hooks/post-write-validate.sh +24 -0
  909. package/framework/modules/core/hooks/pre-bash-safety.sh +44 -0
  910. package/framework/modules/core/hooks/pre-commit-skill-reminder.sh +24 -0
  911. package/framework/modules/core/hooks/pre-write-quality.sh +24 -0
  912. package/framework/modules/core/hooks/session-compact-context.sh +37 -0
  913. package/framework/modules/core/hooks/session-end-reminder.sh +36 -0
  914. package/framework/modules/core/hooks/session-start-context.sh +33 -0
  915. package/framework/modules/core/hooks/session-start-worktree.sh +30 -0
  916. package/framework/modules/core/hooks/skill-reminder.sh +24 -0
  917. package/framework/modules/core/hooks/stop-commit-check.sh +24 -0
  918. package/framework/modules/core/hooks/stop-pr-suggest.sh +42 -0
  919. package/framework/modules/core/hooks/stop-quality-check.sh +24 -0
  920. package/framework/modules/core/hooks/subagent-context-loader.sh +24 -0
  921. package/framework/modules/core/module.json +205 -0
  922. package/framework/modules/core/registries/schemas/agents.schema.json +209 -0
  923. package/framework/modules/core/registries/schemas/command.schema.json +98 -0
  924. package/framework/modules/core/registries/schemas/custom-agent.schema.json +108 -0
  925. package/framework/modules/core/registries/schemas/module.schema.json +233 -0
  926. package/framework/modules/core/registries/schemas/template.schema.json +164 -0
  927. package/framework/modules/core/registries/skill-triggers.json +196 -0
  928. package/framework/modules/core/skills/building-agents/AGENT-TEMPLATE.md +289 -0
  929. package/framework/modules/core/skills/building-agents/CONTENT-ROUTING.md +302 -0
  930. package/framework/modules/core/skills/building-agents/EXAMPLES.md +448 -0
  931. package/framework/modules/core/skills/building-agents/SKILL.md +289 -0
  932. package/framework/modules/core/skills/building-agents/VALIDATION-CHECKLIST.md +304 -0
  933. package/framework/modules/core/skills/building-context/CONTENT-GUIDELINES.md +471 -0
  934. package/framework/modules/core/skills/building-context/EXAMPLES.md +1606 -0
  935. package/framework/modules/core/skills/building-context/LEVEL-DECISION-TREE.md +262 -0
  936. package/framework/modules/core/skills/building-context/SKILL.md +479 -0
  937. package/framework/modules/core/skills/building-context/VALIDATION-CHECKLIST.md +358 -0
  938. package/framework/modules/core/skills/building-framework/AGENT-CREATION-WORKFLOW.md +268 -0
  939. package/framework/modules/core/skills/building-framework/DECISION-TREES.md +183 -0
  940. package/framework/modules/core/skills/building-framework/EXAMPLES.md +387 -0
  941. package/framework/modules/core/skills/building-framework/GOVERNANCE-RULES.md +446 -0
  942. package/framework/modules/core/skills/building-framework/GOVERNANCE-UPDATE-WORKFLOW.md +172 -0
  943. package/framework/modules/core/skills/building-framework/REGISTRY-GUIDE.md +551 -0
  944. package/framework/modules/core/skills/building-framework/SCOPE-DECISION-TREE.md +284 -0
  945. package/framework/modules/core/skills/building-framework/SKILL.md +210 -0
  946. package/framework/modules/core/skills/building-skills/ANTI-PATTERNS-CONTENT.md +219 -0
  947. package/framework/modules/core/skills/building-skills/ANTI-PATTERNS-MCP.md +119 -0
  948. package/framework/modules/core/skills/building-skills/ANTI-PATTERNS-NAMING.md +129 -0
  949. package/framework/modules/core/skills/building-skills/ANTI-PATTERNS-STRUCTURE.md +139 -0
  950. package/framework/modules/core/skills/building-skills/EXAMPLES.md +330 -0
  951. package/framework/modules/core/skills/building-skills/PATTERNS.md +523 -0
  952. package/framework/modules/core/skills/building-skills/SKILL-CREATION-WORKFLOW-FRAMEWORK.md +253 -0
  953. package/framework/modules/core/skills/building-skills/SKILL.md +543 -0
  954. package/framework/modules/core/skills/committing-code/EXAMPLES.md +567 -0
  955. package/framework/modules/core/skills/committing-code/SKILL.md +285 -0
  956. package/framework/modules/core/skills/committing-code/STANDARDS-BRANCHES.md +95 -0
  957. package/framework/modules/core/skills/committing-code/STANDARDS-COMMITS.md +140 -0
  958. package/framework/modules/core/skills/committing-code/STANDARDS-FRAMEWORK.md +234 -0
  959. package/framework/modules/core/skills/committing-code/STANDARDS-TICKETS.md +102 -0
  960. package/framework/modules/core/skills/gathering-intelligence/SKILL.md +136 -0
  961. package/framework/modules/core/skills/managing-versions/EXAMPLES.md +277 -0
  962. package/framework/modules/core/skills/managing-versions/SCRIPTS-REFERENCE.md +295 -0
  963. package/framework/modules/core/skills/managing-versions/SKILL.md +260 -0
  964. package/framework/modules/core/skills/managing-versions/STANDARDS.md +231 -0
  965. package/framework/modules/core/skills/using-context/EXAMPLES.md +257 -0
  966. package/framework/modules/core/skills/using-context/SKILL.md +238 -0
  967. package/framework/modules/core/skills/using-context/STANDARDS.md +241 -0
  968. package/framework/modules/core/skills/using-framework/BEST-PRACTICES.md +421 -0
  969. package/framework/modules/core/skills/using-framework/DISCOVERY-ENGINE-ARCHITECTURE.md +331 -0
  970. package/framework/modules/core/skills/using-framework/EXAMPLES.md +535 -0
  971. package/framework/modules/core/skills/using-framework/ROUTES-REGISTRY-DESIGN.md +455 -0
  972. package/framework/modules/core/skills/using-framework/SKILL.md +176 -0
  973. package/framework/modules/core/skills/using-mcp/ANTI-PATTERNS.md +566 -0
  974. package/framework/modules/core/skills/using-mcp/DECISION-MATRICES.md +385 -0
  975. package/framework/modules/core/skills/using-mcp/EXAMPLES.md +466 -0
  976. package/framework/modules/core/skills/using-mcp/FRAMEWORK-MCP-PATTERNS.md +395 -0
  977. package/framework/modules/core/skills/using-mcp/QUICK-REFERENCE.md +98 -0
  978. package/framework/modules/core/skills/using-mcp/SKILL.md +624 -0
  979. package/framework/modules/core/skills/using-mcp/TOOLS-REFERENCE.md +532 -0
  980. package/framework/modules/core/skills/validating-links/EXAMPLES.md +326 -0
  981. package/framework/modules/core/skills/validating-links/SKILL.md +307 -0
  982. package/framework/modules/core/skills/validating-links/STANDARDS.md +353 -0
  983. package/framework/modules/core/skills/validating-markdown/EXAMPLES.md +516 -0
  984. package/framework/modules/core/skills/validating-markdown/SKILL.md +503 -0
  985. package/framework/modules/core/skills/validating-markdown/VALIDATION-RULES.md +360 -0
  986. package/framework/modules/core/skills/validating-markdown/YAML-SCHEMA.md +424 -0
  987. package/framework/modules/core/skills/verifying-quality/ANTI-PATTERNS.md +302 -0
  988. package/framework/modules/core/skills/verifying-quality/CLI-TESTING.md +389 -0
  989. package/framework/modules/core/skills/verifying-quality/DEFENSIVE-CODING.md +433 -0
  990. package/framework/modules/core/skills/verifying-quality/EVALUATION-PROTOCOL.md +106 -0
  991. package/framework/modules/core/skills/verifying-quality/EXAMPLES.md +588 -0
  992. package/framework/modules/core/skills/verifying-quality/QUALITY-CHECKLIST.md +181 -0
  993. package/framework/modules/core/skills/verifying-quality/SKILL.md +275 -0
  994. package/framework/modules/core/templates/agent/agent.template.md +97 -0
  995. package/framework/modules/core/templates/agent/template.config.json +47 -0
  996. package/framework/modules/core/templates/config/agentic-framework.json.template +17 -0
  997. package/framework/modules/core/templates/config/hooks/pre-commit-sync.sh.template +190 -0
  998. package/framework/modules/core/templates/config/hooks/pre-push.sh.template +330 -0
  999. package/framework/modules/core/templates/config/settings.local.json.template +39 -0
  1000. package/framework/modules/core/templates/config/statusline.sh.template +253 -0
  1001. package/framework/modules/core/templates/context/business-advanced.template.md +71 -0
  1002. package/framework/modules/core/templates/context/business-basic.template.md +39 -0
  1003. package/framework/modules/core/templates/context/business-expert.template.md +95 -0
  1004. package/framework/modules/core/templates/context/process-advanced.template.md +141 -0
  1005. package/framework/modules/core/templates/context/process-basic.template.md +87 -0
  1006. package/framework/modules/core/templates/context/process-expert.template.md +213 -0
  1007. package/framework/modules/core/templates/context/technical-advanced.template.md +111 -0
  1008. package/framework/modules/core/templates/context/technical-basic.template.md +66 -0
  1009. package/framework/modules/core/templates/context/technical-expert.template.md +157 -0
  1010. package/framework/modules/core/templates/module/module.json.template +20 -0
  1011. package/framework/modules/core/templates/module/template.config.json +41 -0
  1012. package/framework/modules/core/templates/skill/SKILL.md.template +96 -0
  1013. package/framework/modules/core/templates/skill/template.config.json +39 -0
  1014. package/framework/modules/jira/agents/ai-jira-manager.md +320 -0
  1015. package/framework/modules/jira/commands/cmd-jira-export.md +42 -0
  1016. package/framework/modules/jira/commands/cmd-jira-sync.md +42 -0
  1017. package/framework/modules/jira/module.json +55 -0
  1018. package/framework/modules/jira/schemas/jira-sync.config.json +75 -0
  1019. package/framework/modules/jira/skills/jira/integrating-jira/CONFLUENCE-PATTERNS.md +284 -0
  1020. package/framework/modules/jira/skills/jira/integrating-jira/CONVERSION-RULES.md +188 -0
  1021. package/framework/modules/jira/skills/jira/integrating-jira/EXAMPLES.md +406 -0
  1022. package/framework/modules/jira/skills/jira/integrating-jira/JIRA-PATTERNS.md +284 -0
  1023. package/framework/modules/jira/skills/jira/integrating-jira/SKILL.md +412 -0
  1024. package/framework/modules/reporting/agents/ai-report-manager.md +410 -0
  1025. package/framework/modules/reporting/module.json +35 -0
  1026. package/framework/modules/reporting/skills/reporting/building-reports/EXAMPLES.md +613 -0
  1027. package/framework/modules/reporting/skills/reporting/building-reports/SKILL.md +509 -0
  1028. package/framework/modules/writer/BUILD_SYSTEM.md +325 -0
  1029. package/framework/modules/writer/MIGRATION.md +326 -0
  1030. package/framework/modules/writer/agents/ai-book-writer.md +196 -0
  1031. package/framework/modules/writer/agents/ai-prose-writer.md +58 -0
  1032. package/framework/modules/writer/agents/ai-world-builder.md +46 -0
  1033. package/framework/modules/writer/commands/cmd-writer-add-fact.md +42 -0
  1034. package/framework/modules/writer/commands/cmd-writer-analyze.md +42 -0
  1035. package/framework/modules/writer/commands/cmd-writer-build.md +42 -0
  1036. package/framework/modules/writer/commands/cmd-writer-create-chapter.md +42 -0
  1037. package/framework/modules/writer/commands/cmd-writer-create-character.md +42 -0
  1038. package/framework/modules/writer/commands/cmd-writer-create-history-event.md +42 -0
  1039. package/framework/modules/writer/commands/cmd-writer-create-magic-system.md +42 -0
  1040. package/framework/modules/writer/commands/cmd-writer-create-nation.md +42 -0
  1041. package/framework/modules/writer/commands/cmd-writer-create-part.md +42 -0
  1042. package/framework/modules/writer/commands/cmd-writer-create-region.md +42 -0
  1043. package/framework/modules/writer/commands/cmd-writer-create-scene.md +42 -0
  1044. package/framework/modules/writer/commands/cmd-writer-create-world-rule.md +42 -0
  1045. package/framework/modules/writer/commands/cmd-writer-export.md +42 -0
  1046. package/framework/modules/writer/commands/cmd-writer-generate-context.md +42 -0
  1047. package/framework/modules/writer/commands/cmd-writer-init-baseline.md +42 -0
  1048. package/framework/modules/writer/commands/cmd-writer-init.md +42 -0
  1049. package/framework/modules/writer/commands/cmd-writer-lock-fact.md +42 -0
  1050. package/framework/modules/writer/commands/cmd-writer-validate-immutability.md +42 -0
  1051. package/framework/modules/writer/commands/cmd-writer-validate.md +42 -0
  1052. package/framework/modules/writer/module.json +181 -0
  1053. package/framework/modules/writer/schemas/baseline.schema.json +60 -0
  1054. package/framework/modules/writer/schemas/manifest.schema.json +155 -0
  1055. package/framework/modules/writer/schemas/prerequisites.schema.json +171 -0
  1056. package/framework/modules/writer/schemas/token-budgets.json +129 -0
  1057. package/framework/modules/writer/schemas/token-budgets.schema.json +92 -0
  1058. package/framework/modules/writer/schemas/world-fact.schema.json +172 -0
  1059. package/framework/modules/writer/schemas/world-lock.schema.json +244 -0
  1060. package/framework/modules/writer/skills/writer/building-worlds/CONSISTENCY-PILLARS.md +412 -0
  1061. package/framework/modules/writer/skills/writer/building-worlds/CULTURE-BUILDING.md +354 -0
  1062. package/framework/modules/writer/skills/writer/building-worlds/GEOGRAPHY-HISTORY.md +293 -0
  1063. package/framework/modules/writer/skills/writer/building-worlds/MAGIC-SYSTEMS.md +311 -0
  1064. package/framework/modules/writer/skills/writer/building-worlds/REVELATION-CHECKLIST.md +282 -0
  1065. package/framework/modules/writer/skills/writer/building-worlds/SKILL.md +313 -0
  1066. package/framework/modules/writer/skills/writer/organizing-books/DOMAINS.md +212 -0
  1067. package/framework/modules/writer/skills/writer/organizing-books/FOLDER-STRUCTURE.md +593 -0
  1068. package/framework/modules/writer/skills/writer/organizing-books/IMMUTABILITY-GUIDE.md +350 -0
  1069. package/framework/modules/writer/skills/writer/organizing-books/METADATA-GUIDE.md +780 -0
  1070. package/framework/modules/writer/skills/writer/organizing-books/SKILL.md +257 -0
  1071. package/framework/modules/writer/skills/writer/organizing-books/SSOT-RULES.md +214 -0
  1072. package/framework/modules/writer/skills/writer/organizing-books/WORLD-STRUCTURE.md +222 -0
  1073. package/framework/modules/writer/skills/writer/organizing-books/templates/chapter.template.md +57 -0
  1074. package/framework/modules/writer/skills/writer/organizing-books/templates/character.template.md +121 -0
  1075. package/framework/modules/writer/skills/writer/organizing-books/templates/part.template.md +67 -0
  1076. package/framework/modules/writer/skills/writer/organizing-books/templates/scene.template.md +62 -0
  1077. package/framework/modules/writer/skills/writer/organizing-books/templates/template.config.json +114 -0
  1078. package/framework/modules/writer/skills/writer/writing-prose/CHARACTER-VOICE.md +654 -0
  1079. package/framework/modules/writer/skills/writer/writing-prose/DESCRIPTION-TECHNIQUES.md +688 -0
  1080. package/framework/modules/writer/skills/writer/writing-prose/DIALOGUE-GUIDE.md +663 -0
  1081. package/framework/modules/writer/skills/writer/writing-prose/PACING-STRUCTURE.md +613 -0
  1082. package/framework/modules/writer/skills/writer/writing-prose/PROSE-PATTERNS.md +569 -0
  1083. package/framework/modules/writer/skills/writer/writing-prose/SKILL.md +583 -0
  1084. package/framework/modules/writer/skills/writer/writing-prose/WORLD-BUILDING-RULES.md +692 -0
  1085. package/framework/modules/writer/skills/writer/writing-prose/examples/blended-accessible.md +651 -0
  1086. package/framework/modules/writer/skills/writer/writing-prose/examples/tolkien-style.md +534 -0
  1087. package/framework/modules/writer/skills/writer/writing-prose/examples/zelazny-style.md +415 -0
  1088. package/framework/modules/writer/src/package.json +3 -0
  1089. package/framework/modules/writer/templates/package.json +28 -0
  1090. package/framework/modules/writer/templates/world/baseline.template.md +183 -0
  1091. package/framework/modules/writer/templates/world/history-event.template.md +89 -0
  1092. package/framework/modules/writer/templates/world/magic-system.template.md +138 -0
  1093. package/framework/modules/writer/templates/world/manifest.template.json +9 -0
  1094. package/framework/modules/writer/templates/world/nation.template.md +123 -0
  1095. package/framework/modules/writer/templates/world/region.template.md +65 -0
  1096. package/framework/modules/writer/templates/world/world-rule.template.md +50 -0
  1097. package/package.json +110 -0
@@ -0,0 +1,534 @@
1
+ # Tolkien-Style Examples
2
+
3
+ Extended examples demonstrating J.R.R. Tolkien's narrative techniques with annotations explaining what makes them effective.
4
+
5
+ ## Example 1: Opening with History and Wonder
6
+
7
+ ```
8
+ The road had been built in the Second Age, when the Numenoreans
9
+ still held strength in Middle-earth. Its stones, though worn and
10
+ broken in places, bore the mark of their craft—perfectly fitted,
11
+ mortarless, enduring. Three thousand years had passed since their
12
+ hands last touched these stones, yet the work remained.
13
+
14
+ Elrond paused where the road bent around an ancient oak. The tree
15
+ had been young when the road was new. Now it was gnarled and vast,
16
+ its roots breaking through the stonework in places. Even the works
17
+ of Numenor yielded to the patience of living things.
18
+
19
+ "Do you see?" he asked, gesturing to the stones. "The old world
20
+ passing, the new world growing through its cracks. This is the
21
+ way of things. Nothing endures forever, save the turning of the
22
+ seasons and the slow wearing of stone."
23
+
24
+ I looked at the road, the tree, the elf who had watched both
25
+ for longer than my people had possessed written language. Everything
26
+ was ancient here. Even the air tasted of time.
27
+ ```
28
+
29
+ **Annotations:**
30
+
31
+ **Historical depth immediately:**
32
+ - Second Age reference (reader doesn't need to know details)
33
+ - Three thousand years casually mentioned
34
+ - Numenoreans introduced through their works
35
+
36
+ **Craftsmanship noted:**
37
+ - "Perfectly fitted, mortarless, enduring"
38
+ - Quality demonstrates civilization
39
+ - Specific technical details ground history
40
+
41
+ **Deep time perspective:**
42
+ - Tree was young when road was new
43
+ - Now the tree breaks the road
44
+ - Time scale beyond human comprehension
45
+
46
+ **Nature as force:**
47
+ - "Patience of living things"
48
+ - Not destructive, patient
49
+ - Natural vs. constructed in eternal contest
50
+
51
+ **Formal speech:**
52
+ - "Do you see?"
53
+ - "This is the way of things"
54
+ - Teaching moment, mythic voice
55
+
56
+ **Thematic statement:**
57
+ - Nothing endures except nature
58
+ - Cycles and seasons eternal
59
+ - Melancholy but not hopeless
60
+
61
+ **POV wonder:**
62
+ - "Even the air tasted of time"
63
+ - Protagonist overwhelmed by age
64
+ - Human perspective in ancient world
65
+
66
+ ## Example 2: Council Scene with Multiple Perspectives
67
+
68
+ ```
69
+ The council chamber fell silent as Gandalf rose to speak. He stood
70
+ for a moment in thought, his eyes distant, as if seeing things far
71
+ beyond the walls of Rivendell. When he spoke, his voice was grave.
72
+
73
+ "Long have I feared that this day would come. The Enemy stirs in
74
+ the East, and his reach grows long. What was hidden is now revealed.
75
+ What was lost is now found. And we must choose—will we face what
76
+ comes, or will we turn away and let darkness have its victory?"
77
+
78
+ "Fair words," said Boromir, "but what would you have us do? March
79
+ to Mordor's gates? Cast ourselves against an enemy that has broken
80
+ kingdoms and brought down the mighty? This is counsel of despair,
81
+ not wisdom."
82
+
83
+ "Despair?" Aragorn's voice was quiet but hard. "Despair is surrender.
84
+ This is necessity. The Ring exists. We cannot unmake that truth by
85
+ wishing it otherwise."
86
+
87
+ "The Ring should be destroyed," Elrond said with finality. "This
88
+ much is clear. But who among us has the strength to cast it into
89
+ the fires of Mount Doom?"
90
+
91
+ Silence again. The question hung in the air like a sword suspended
92
+ by a thread.
93
+
94
+ Then a small voice spoke from the shadows. "I will take it."
95
+
96
+ Every eye turned to Frodo. He seemed to shrink under their gaze,
97
+ yet he stood.
98
+
99
+ "I will take it," he said again, more firmly. "Though I do not
100
+ know the way."
101
+ ```
102
+
103
+ **Annotations:**
104
+
105
+ **Formal council structure:**
106
+ - Rising to speak (ceremonial)
107
+ - Listening in silence (respect)
108
+ - Turn-taking in debate
109
+
110
+ **Gandalf's gravitas:**
111
+ - Eyes distant (seeing beyond)
112
+ - Voice grave (weight of knowledge)
113
+ - Formal rhythm in speech
114
+
115
+ **Prophetic language:**
116
+ - "What was hidden is now revealed"
117
+ - Parallel structure (was/now)
118
+ - Mythic tone without obscurity
119
+
120
+ **Contrasting voices:**
121
+ - Gandalf: prophetic, formal
122
+ - Boromir: practical, skeptical
123
+ - Aragorn: terse, absolute
124
+ - Elrond: authoritative, conclusive
125
+ - Frodo: hesitant, determined
126
+
127
+ **Boromir's challenge:**
128
+ - Practical objection
129
+ - Historical evidence (broken kingdoms)
130
+ - "Counsel of despair" = strong accusation
131
+
132
+ **Aragorn's response:**
133
+ - Redefines despair
134
+ - Absolute statement of reality
135
+ - Shorter, harder language
136
+
137
+ **The question:**
138
+ - "Who among us has the strength"
139
+ - Not asking for volunteer
140
+ - Acknowledging difficulty
141
+
142
+ **Silence as weight:**
143
+ - "Like a sword suspended by a thread"
144
+ - Metaphor conveys tension
145
+ - Visual image of danger
146
+
147
+ **Heroic moment:**
148
+ - Small voice from shadows
149
+ - Physical diminishment (shrinks)
150
+ - Moral enlargement (stands)
151
+ - Repetition for certainty
152
+ - Admission of ignorance with commitment
153
+
154
+ ## Example 3: Landscape Description with Emotional Weight
155
+
156
+ ```
157
+ The valley of Rivendell lay below them, hidden in the fold of the
158
+ mountains like a secret kept by stone and water. Even in the failing
159
+ light of autumn, it held a quality of preserved summer—the trees
160
+ still green, the air still warm, the sound of falling water constant
161
+ and consoling.
162
+
163
+ Frodo stood at the edge of the pass and looked down into that
164
+ sheltered place. He had been walking for weeks through lands that
165
+ grew steadily darker and more dangerous. The Shire seemed a lifetime
166
+ behind him now, though it had been only months. Here, at last, was
167
+ sanctuary. A place where evil had not yet cast its shadow.
168
+
169
+ "It is fair," Gandalf said beside him, "and it has been fair for
170
+ many long years. Elrond has held this valley against the darkness
171
+ since before your people came to the Shire. It is a house of healing,
172
+ and you are in need of healing, Frodo Baggins."
173
+
174
+ The words were truer than Frodo wanted to admit. He was tired. Not
175
+ just the tiredness of the road, but a deeper weariness that had
176
+ settled into his bones. The Ring had grown heavier with each mile,
177
+ though its weight never changed. It was his awareness of it that
178
+ grew—a constant whisper at the edge of thought, a cold presence
179
+ against his chest.
180
+
181
+ But here, for a moment, the whisper seemed distant. The valley
182
+ held a power of its own, older and gentler than the dark thing
183
+ he carried. He breathed deeply and felt some of the tension leave
184
+ his shoulders.
185
+
186
+ "How long can we stay?" he asked.
187
+
188
+ "As long as you need," Gandalf said. "Though not, I think, as long
189
+ as you might wish."
190
+
191
+ That was the way of things now. Safety was temporary. Rest was
192
+ borrowed. The road always waited.
193
+ ```
194
+
195
+ **Annotations:**
196
+
197
+ **Opening with scale:**
198
+ - Valley hidden in mountains
199
+ - Geography specific (fold of mountains)
200
+ - "Secret kept by stone and water" = poetic but clear
201
+
202
+ **Preserved beauty:**
203
+ - "Quality of preserved summer"
204
+ - Autumn outside, summer within
205
+ - Magic implied, not stated
206
+
207
+ **Sensory details:**
208
+ - Visual (green trees)
209
+ - Temperature (warm air)
210
+ - Sound (falling water)
211
+ - "Constant and consoling" = emotional weight
212
+
213
+ **Character journey:**
214
+ - Weeks of danger
215
+ - Shire in distant past
216
+ - Emotional distance matches physical
217
+
218
+ **Sanctuary concept:**
219
+ - "Place where evil had not yet cast its shadow"
220
+ - "Yet" = knowledge of impermanence
221
+ - Refuge, not permanent safety
222
+
223
+ **Formal speech (Gandalf):**
224
+ - "It is fair"
225
+ - "Many long years"
226
+ - No contractions
227
+ - Teaching tone
228
+
229
+ **Historical depth:**
230
+ - "Since before your people came to the Shire"
231
+ - Elrond's stewardship ancient
232
+ - Human perspective dwarfed
233
+
234
+ **Internal struggle:**
235
+ - Physical tired vs. spiritual weariness
236
+ - Ring's psychological weight
237
+ - "Constant whisper" = perfect metaphor
238
+
239
+ **Power vs. Power:**
240
+ - Dark power (Ring)
241
+ - Gentle power (valley)
242
+ - Older power provides respite
243
+
244
+ **Melancholy wisdom:**
245
+ - "Not as long as you might wish"
246
+ - Safety temporary
247
+ - "The road always waited" = inevitable journey
248
+
249
+ ## Example 4: Heroic Journey Acceptance
250
+
251
+ ```
252
+ The morning came grey and cold. Frodo woke to find frost on the
253
+ windows and reluctance in his heart. He had known this day would
254
+ come. Had known it since the council. Perhaps had known it since
255
+ Gandalf first told him what the Ring truly was.
256
+
257
+ Knowing and accepting were different things.
258
+
259
+ He dressed slowly, aware that each familiar action was one he might
260
+ not perform again. The simple acts of his old life—pulling on boots,
261
+ fastening his cloak, checking his pack—felt precious now. He was
262
+ leaving them behind. Leaving the person who had performed them
263
+ thoughtlessly every day for years.
264
+
265
+ When he emerged from his room, Sam was waiting.
266
+
267
+ "I heard," Sam said simply. "That you'd volunteered."
268
+
269
+ "I didn't volunteer. Not exactly. I just—" Frodo stopped. There
270
+ was no way to explain the moment in the council when he'd spoken.
271
+ It hadn't felt like choice. More like recognition. Like seeing a
272
+ path that had always been there, waiting for him to notice it.
273
+
274
+ "I have to go," he said finally. "Someone has to. And I'm already
275
+ carrying it."
276
+
277
+ "Then I'm going with you." Sam's jaw was set in that stubborn way
278
+ that Frodo knew well. "You'll need someone to carry things. And to
279
+ do the cooking. And to make sure you don't do anything foolish."
280
+
281
+ "This whole thing is foolish, Sam."
282
+
283
+ "All the more reason you need me, then."
284
+
285
+ Frodo tried to argue. Tried to explain the danger, the likelihood
286
+ of death, the probability that they would never return. Sam listened
287
+ patiently to every word.
288
+
289
+ Then he picked up Frodo's pack.
290
+
291
+ "We'd better get started," he said. "It's a long walk to Mordor."
292
+ ```
293
+
294
+ **Annotations:**
295
+
296
+ **Reluctance acknowledged:**
297
+ - "Reluctance in his heart"
298
+ - Not eager hero
299
+ - Realistic emotional response
300
+
301
+ **Knowing vs. accepting:**
302
+ - Philosophical observation
303
+ - Two-word paragraph for weight
304
+ - Universal truth simply stated
305
+
306
+ **Ritual of departure:**
307
+ - Familiar actions precious
308
+ - Awareness transforms mundane
309
+ - Leaving self behind, not just place
310
+
311
+ **Forced articulation:**
312
+ - Can't explain the moment
313
+ - "Recognition" not "choice"
314
+ - Destiny felt, not chosen
315
+
316
+ **Simple necessity:**
317
+ - "Someone has to"
318
+ - "I'm already carrying it"
319
+ - Logic of burden
320
+
321
+ **Sam's loyalty:**
322
+ - No grand speech
323
+ - Practical reasons (cooking, carrying)
324
+ - Love disguised as utility
325
+
326
+ **Frodo's honesty:**
327
+ - Tries to dissuade
328
+ - Lists real dangers
329
+ - Doesn't hide truth
330
+
331
+ **Sam's resolution:**
332
+ - Listens to all arguments
333
+ - Action instead of counter-argument
334
+ - Picks up pack = decision made
335
+
336
+ **Understated journey:**
337
+ - "Long walk to Mordor"
338
+ - Epic quest as simple walk
339
+ - Compression of terror into normalcy
340
+
341
+ ## Example 5: Ancient Being Perspective
342
+
343
+ ```
344
+ Treebeard stood in the clearing, ancient as the mountains, patient
345
+ as stone. The Ents had walked the forests of Middle-earth since
346
+ before the moon was made, and Treebeard remembered. He remembered
347
+ when the elves first taught trees to speak. He remembered the first
348
+ age of the world, when everything was young and the darkness had
349
+ not yet come.
350
+
351
+ Now the darkness had come many times and been driven back. And come
352
+ again. And would come again still, he suspected. That was the way
353
+ of the world. Light and dark, growth and decay, the endless turning
354
+ of the great wheel.
355
+
356
+ "You are young," he said to Merry and Pippin, and his voice was
357
+ like the creaking of great branches in wind. "Very young. You see
358
+ only the moment, not the long slow arc of things. The trees grow
359
+ slowly. The stones erode slowly. Evil rises and falls, but the forest
360
+ endures."
361
+
362
+ "But Saruman is cutting down the forest," Merry protested. "Now.
363
+ Today. We can't wait for the long slow arc."
364
+
365
+ Treebeard was silent for a long time. When Ents thought, they thought
366
+ deeply. They thought in tree-time, not the hasty seconds of humans.
367
+
368
+ "Hoom," he said at last. "Yes. That is the trouble with being hasty.
369
+ Sometimes the hasty are right, and the slow are too late. I had not
370
+ thought the time for hastiness had come. But perhaps it has."
371
+
372
+ He straightened, and the hobbits took a step back. He seemed to grow
373
+ larger, though he had not moved. Ancient power stirred in him, the
374
+ wrath of forests when their patience finally breaks.
375
+
376
+ "We will be hasty," he said. "The trees will march to war."
377
+ ```
378
+
379
+ **Annotations:**
380
+
381
+ **Deep time established:**
382
+ - "Since before the moon was made"
383
+ - Mythological scale
384
+ - Age beyond comprehension
385
+
386
+ **Historical layering:**
387
+ - Elves taught trees to speak
388
+ - First age remembered
389
+ - Multiple cycles of darkness
390
+
391
+ **Cyclical worldview:**
392
+ - "Come and been driven back"
393
+ - Wheel metaphor
394
+ - Inevitability of pattern
395
+
396
+ **Formal ancient speech:**
397
+ - "Hoom" (thoughtful sound)
398
+ - No contractions
399
+ - Measured cadence
400
+ - Tree-slow rhythm
401
+
402
+ **Generational perspective:**
403
+ - Hobbits are young (true for any human-scale being)
404
+ - See moment vs. arc
405
+ - Different time scales, different wisdom
406
+
407
+ **Contrast of urgency:**
408
+ - Treebeard: geological patience
409
+ - Merry: immediate crisis
410
+ - Both perspectives valid
411
+
412
+ **Deep thought rendered:**
413
+ - "Long time" of silence
414
+ - "Thought in tree-time"
415
+ - Anthropomorphizing thought process
416
+
417
+ **Turning point:**
418
+ - "Sometimes the hasty are right"
419
+ - Acknowledging limit of patience
420
+ - Ancient being adapts worldview
421
+
422
+ **Power through stillness:**
423
+ - "Seemed to grow larger, though he had not moved"
424
+ - Presence increases without physical change
425
+ - "Ancient power stirred"
426
+
427
+ **Momentous decision:**
428
+ - "Trees will march to war"
429
+ - Oxymoron (trees don't march)
430
+ - Mythic weight in simple statement
431
+
432
+ ## Example 6: Songs and Stories Within Story
433
+
434
+ ```
435
+ That night, as they sat around the fire in the hall of Elrond,
436
+ Bilbo rose to speak. He was old now, far older than any hobbit
437
+ had right to be, and the years weighed on him. But his eyes still
438
+ sparkled when he spoke of old adventures.
439
+
440
+ "I made a song," he said, "about my journey to the Mountain and
441
+ back again. It's not very good, I'm afraid. But it tells the
442
+ truth of things, after a fashion."
443
+
444
+ He cleared his throat and began:
445
+
446
+ *The road goes ever on and on,*
447
+ *Down from the door where it began.*
448
+ *Now far ahead the road has gone,*
449
+ *And I must follow, if I can.*
450
+
451
+ The words were simple, but they held something deeper. Every person
452
+ in that hall had walked roads of their own. Every one had left
453
+ something behind, had followed paths they hadn't chosen, had
454
+ wondered if they would ever find their way home.
455
+
456
+ Frodo listened and felt the weight of his own road before him.
457
+ Bilbo had walked to the Mountain and returned. Would Frodo be so
458
+ fortunate?
459
+
460
+ When the song ended, there was silence. Then Aragorn spoke, his
461
+ voice carrying the weight of his own long road.
462
+
463
+ "Your song has truth in it, Bilbo Baggins. The road does go ever
464
+ on. We follow it or we do not. But once the first step is taken,
465
+ the road has a way of leading us where we need to go. Not always
466
+ where we wish. But where we need."
467
+
468
+ Gandalf nodded slowly. "The old songs often have more wisdom than
469
+ new counsel. They have been tested by time and found true. This
470
+ is why we preserve them, even when—especially when—they speak of
471
+ sorrow and loss. They remind us that others have walked these roads
472
+ before, and found the strength to continue."
473
+ ```
474
+
475
+ **Annotations:**
476
+
477
+ **Framing the verse:**
478
+ - Bilbo's age and weariness
479
+ - Self-deprecation ("not very good")
480
+ - "Truth of things" = value beyond craft
481
+
482
+ **Simple verse:**
483
+ - Short lines
484
+ - Clear rhythm
485
+ - Easily memorable
486
+ - Folk song quality
487
+
488
+ **Universal resonance:**
489
+ - Every listener has own road
490
+ - Personal application of general truth
491
+ - Shared experience through metaphor
492
+
493
+ **Linking to present:**
494
+ - Frodo's application to his journey
495
+ - Bilbo returned (will Frodo?)
496
+ - Song becomes prophecy/question
497
+
498
+ **Wise interpretation:**
499
+ - Aragorn unpacks meaning
500
+ - "Need" vs. "wish" distinction
501
+ - Road as destiny/guide
502
+
503
+ **Meta-commentary:**
504
+ - Songs tested by time
505
+ - Sorrow and loss preserved
506
+ - "Others have walked before"
507
+ - Tradition as comfort
508
+
509
+ **Function in narrative:**
510
+ - Breaks prose rhythm
511
+ - Provides thematic statement
512
+ - Links past and future
513
+ - Elevates stakes through art
514
+
515
+ ## Key Tolkien Techniques Summary
516
+
517
+ 1. **Historical Depth** - Past visible in present
518
+ 2. **Formal Speech** - Elevated without obscurity
519
+ 3. **Natural World** - Landscape has character
520
+ 4. **Multiple Perspectives** - Different cultures, different views
521
+ 5. **Songs and Stories** - Art within narrative
522
+ 6. **Deep Time** - Geological/mythological scales
523
+ 7. **Reluctant Heroes** - Duty over glory
524
+ 8. **Cyclical Wisdom** - Patterns repeat
525
+ 9. **Named Things** - Proper nouns carry weight
526
+ 10. **Melancholy Hope** - Loss certain, trying anyway
527
+
528
+ ---
529
+
530
+ **Reading Level:** Grade 10-12 (adapted from original)
531
+ **Sentence Avg:** 15-20 words (description) to 12-15 (dialogue)
532
+ **Paragraph Max:** 5 sentences maintained
533
+
534
+ **Next:** See [blended-accessible.md](./blended-accessible.md) for synthesis of both styles.