@christianmaf80/agentic-workflow 1.8.0-beta.1 → 1.11.0-beta.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 (359) hide show
  1. package/dist/artifacts/1-mcp-server-extensio-cli/analysis.md +480 -0
  2. package/dist/artifacts/1-mcp-server-extensio-cli/architect/review.md +285 -0
  3. package/dist/artifacts/1-mcp-server-extensio-cli/changelog.md +29 -0
  4. package/dist/artifacts/1-mcp-server-extensio-cli/implementer-agent/subtask-implementation.md +321 -0
  5. package/dist/artifacts/1-mcp-server-extensio-cli/plan.md +522 -0
  6. package/dist/artifacts/1-mcp-server-extensio-cli/researcher/research.md +270 -0
  7. package/dist/artifacts/1-mcp-server-extensio-cli/results.md +143 -0
  8. package/dist/artifacts/1-mcp-server-extensio-cli/task-metrics.md +33 -0
  9. package/dist/artifacts/1-mcp-server-extensio-cli/task.md +178 -0
  10. package/dist/artifacts/1-mcp-server-extensio-cli/walkthrough.md +69 -0
  11. package/dist/artifacts/10-shard-build-plugin/analysis.md +290 -0
  12. package/dist/artifacts/10-shard-build-plugin/architect/subtask-implementation.md +105 -0
  13. package/dist/artifacts/10-shard-build-plugin/plan.md +409 -0
  14. package/dist/artifacts/10-shard-build-plugin/researcher/research.md +109 -0
  15. package/dist/artifacts/10-shard-build-plugin/task.md +124 -0
  16. package/dist/artifacts/11-revision-sistema-agentic/analysis.md +43 -0
  17. package/dist/artifacts/11-revision-sistema-agentic/cli-mcp-impact.md +186 -0
  18. package/dist/artifacts/11-revision-sistema-agentic/core-impact.md +162 -0
  19. package/dist/artifacts/11-revision-sistema-agentic/metrics.md +82 -0
  20. package/dist/artifacts/11-revision-sistema-agentic/modules-create-v2.md +126 -0
  21. package/dist/artifacts/11-revision-sistema-agentic/modules-v2.md +250 -0
  22. package/dist/artifacts/11-revision-sistema-agentic/pages-v2.md +366 -0
  23. package/dist/artifacts/11-revision-sistema-agentic/researcher/research.md +131 -0
  24. package/dist/artifacts/11-revision-sistema-agentic/results.md +116 -0
  25. package/dist/artifacts/11-revision-sistema-agentic/shards-v2.md +424 -0
  26. package/dist/artifacts/11-revision-sistema-agentic/task.md +145 -0
  27. package/dist/artifacts/11-revision-sistema-agentic/verification.md +119 -0
  28. package/dist/artifacts/12-adaptacion-core-cli-surfaces/analysis-architecture-change.md +305 -0
  29. package/dist/artifacts/12-adaptacion-core-cli-surfaces/analysis.md +301 -0
  30. package/dist/artifacts/12-adaptacion-core-cli-surfaces/error-analysis.md +93 -0
  31. package/dist/artifacts/12-adaptacion-core-cli-surfaces/implementation-summary.md +111 -0
  32. package/dist/artifacts/12-adaptacion-core-cli-surfaces/plan.md +387 -0
  33. package/dist/artifacts/12-adaptacion-core-cli-surfaces/researcher/research.md +266 -0
  34. package/dist/artifacts/12-adaptacion-core-cli-surfaces/task.md +167 -0
  35. package/dist/artifacts/13-dual-lifecycle-system/analysis.md +173 -0
  36. package/dist/artifacts/13-dual-lifecycle-system/architect/review.md +67 -0
  37. package/dist/artifacts/13-dual-lifecycle-system/plan.md +230 -0
  38. package/dist/artifacts/13-dual-lifecycle-system/researcher/research.md +243 -0
  39. package/dist/artifacts/13-dual-lifecycle-system/task.md +130 -0
  40. package/dist/artifacts/13-dual-lifecycle-system/verification.md +84 -0
  41. package/dist/artifacts/14-core-tests-refactor/analysis.md +240 -0
  42. package/dist/artifacts/14-core-tests-refactor/architect/review.md +33 -0
  43. package/dist/artifacts/14-core-tests-refactor/evaluation.md +40 -0
  44. package/dist/artifacts/14-core-tests-refactor/plan.md +344 -0
  45. package/dist/artifacts/14-core-tests-refactor/researcher/research.md +258 -0
  46. package/dist/artifacts/14-core-tests-refactor/results.md +117 -0
  47. package/dist/artifacts/14-core-tests-refactor/task.md +163 -0
  48. package/dist/artifacts/14-core-tests-refactor/verification.md +87 -0
  49. package/dist/artifacts/15-sistema-evaluacion-agentes/architect/implementation.md +47 -0
  50. package/dist/artifacts/15-sistema-evaluacion-agentes/brief.md +100 -0
  51. package/dist/artifacts/15-sistema-evaluacion-agentes/closure.md +81 -0
  52. package/dist/artifacts/15-sistema-evaluacion-agentes/task.md +83 -0
  53. package/dist/artifacts/16-refactorizacion-demo-core/analysis.md +160 -0
  54. package/dist/artifacts/16-refactorizacion-demo-core/architect/implementation.md +180 -0
  55. package/dist/artifacts/16-refactorizacion-demo-core/changelog.md +15 -0
  56. package/dist/artifacts/16-refactorizacion-demo-core/metrics.md +17 -0
  57. package/dist/artifacts/16-refactorizacion-demo-core/plan.md +270 -0
  58. package/dist/artifacts/16-refactorizacion-demo-core/researcher/research.md +190 -0
  59. package/dist/artifacts/16-refactorizacion-demo-core/task.md +124 -0
  60. package/dist/artifacts/17-implementacion-loadshard-external-agnostic--esm/analysis.md +108 -0
  61. package/dist/artifacts/17-implementacion-loadshard-external-agnostic--esm/architect/review-subtask-1.md +98 -0
  62. package/dist/artifacts/17-implementacion-loadshard-external-agnostic--esm/architect/review.md +192 -0
  63. package/dist/artifacts/17-implementacion-loadshard-external-agnostic--esm/architect/step-4-postponed.md +41 -0
  64. package/dist/artifacts/17-implementacion-loadshard-external-agnostic--esm/module-agent/activation-fix-demo.md +73 -0
  65. package/dist/artifacts/17-implementacion-loadshard-external-agnostic--esm/module-agent/activation-subtask-2.md +80 -0
  66. package/dist/artifacts/17-implementacion-loadshard-external-agnostic--esm/module-agent/fix-demo-implementation.md +113 -0
  67. package/dist/artifacts/17-implementacion-loadshard-external-agnostic--esm/module-agent/subtask-2-implementation.md +133 -0
  68. package/dist/artifacts/17-implementacion-loadshard-external-agnostic--esm/module-agent/subtask-implementation.md +130 -0
  69. package/dist/artifacts/17-implementacion-loadshard-external-agnostic--esm/plan.md +188 -0
  70. package/dist/artifacts/17-implementacion-loadshard-external-agnostic--esm/qa-agent/activation-demo-build.md +80 -0
  71. package/dist/artifacts/17-implementacion-loadshard-external-agnostic--esm/qa-agent/activation-phase-5.md +73 -0
  72. package/dist/artifacts/17-implementacion-loadshard-external-agnostic--esm/qa-agent/activation-subtask-5-7.md +97 -0
  73. package/dist/artifacts/17-implementacion-loadshard-external-agnostic--esm/qa-agent/issue-demo-integrity.md +39 -0
  74. package/dist/artifacts/17-implementacion-loadshard-external-agnostic--esm/qa-agent/subtask-5-7-implementation.md +188 -0
  75. package/dist/artifacts/17-implementacion-loadshard-external-agnostic--esm/qa-agent/verification.md +207 -0
  76. package/dist/artifacts/17-implementacion-loadshard-external-agnostic--esm/researcher/research.md +103 -0
  77. package/dist/artifacts/17-implementacion-loadshard-external-agnostic--esm/subtask-1-engine-refactor.md +64 -0
  78. package/dist/artifacts/17-implementacion-loadshard-external-agnostic--esm/surface-agent/activation-subtask-3.md +81 -0
  79. package/dist/artifacts/17-implementacion-loadshard-external-agnostic--esm/surface-agent/subtask-3-implementation.md +148 -0
  80. package/dist/artifacts/17-implementacion-loadshard-external-agnostic--esm/task.md +146 -0
  81. package/dist/artifacts/18-refactor-phase-4-implementation/task.md +140 -0
  82. package/dist/artifacts/19-refinar-sistema-agentes-ciclo-vida/agent-scores.md +58 -0
  83. package/dist/artifacts/19-refinar-sistema-agentes-ciclo-vida/agent-tasks/1-architect-refactor-research-template.md +78 -0
  84. package/dist/artifacts/19-refinar-sistema-agentes-ciclo-vida/agent-tasks/2-architect-refactor-analysis-template.md +76 -0
  85. package/dist/artifacts/19-refinar-sistema-agentes-ciclo-vida/agent-tasks/3-architect-update-phase1-workflow.md +77 -0
  86. package/dist/artifacts/19-refinar-sistema-agentes-ciclo-vida/agent-tasks/4-architect-update-phase2-workflow.md +76 -0
  87. package/dist/artifacts/19-refinar-sistema-agentes-ciclo-vida/agent-tasks/5-architect-create-todo-structure.md +77 -0
  88. package/dist/artifacts/19-refinar-sistema-agentes-ciclo-vida/agent-tasks/6-qa-validation.md +95 -0
  89. package/dist/artifacts/19-refinar-sistema-agentes-ciclo-vida/analysis.md +190 -0
  90. package/dist/artifacts/19-refinar-sistema-agentes-ciclo-vida/architect/review.md +68 -0
  91. package/dist/artifacts/19-refinar-sistema-agentes-ciclo-vida/plan.md +203 -0
  92. package/dist/artifacts/19-refinar-sistema-agentes-ciclo-vida/researcher/research.md +296 -0
  93. package/dist/artifacts/19-refinar-sistema-agentes-ciclo-vida/task.md +132 -0
  94. package/dist/artifacts/19-refinar-sistema-agentes-ciclo-vida/verification.md +104 -0
  95. package/dist/artifacts/2-review-mcp-agent-system/analysis.md +133 -0
  96. package/dist/artifacts/2-review-mcp-agent-system/architect/infrastructure-migration.md +58 -0
  97. package/dist/artifacts/2-review-mcp-agent-system/architect/mcp-server-refactor.md +57 -0
  98. package/dist/artifacts/2-review-mcp-agent-system/architect/review.md +83 -0
  99. package/dist/artifacts/2-review-mcp-agent-system/changelog.md +22 -0
  100. package/dist/artifacts/2-review-mcp-agent-system/metrics.md +33 -0
  101. package/dist/artifacts/2-review-mcp-agent-system/plan.md +141 -0
  102. package/dist/artifacts/2-review-mcp-agent-system/qa/mcp-test-validation.md +60 -0
  103. package/dist/artifacts/2-review-mcp-agent-system/researcher/research.md +77 -0
  104. package/dist/artifacts/2-review-mcp-agent-system/results-acceptance.md +115 -0
  105. package/dist/artifacts/2-review-mcp-agent-system/task.md +127 -0
  106. package/dist/artifacts/2-review-mcp-agent-system/verification.md +72 -0
  107. package/dist/artifacts/20-anadir-seccion-reasoning-agent-task/analysis.md +139 -0
  108. package/dist/artifacts/20-anadir-seccion-reasoning-agent-task/plan.md +146 -0
  109. package/dist/artifacts/20-anadir-seccion-reasoning-agent-task/researcher/research.md +142 -0
  110. package/dist/artifacts/20-anadir-seccion-reasoning-agent-task/task.md +143 -0
  111. package/dist/artifacts/20-anadir-seccion-reasoning-agent-task/verification.md +53 -0
  112. package/dist/artifacts/2026-01-19-orchestration-init/brief.md +88 -0
  113. package/dist/artifacts/2026-01-19-orchestration-init/closure.md +80 -0
  114. package/dist/artifacts/2026-01-19-orchestration-init/implementation.md +20 -0
  115. package/dist/artifacts/21-portable-agentic-system/researcher/research.md +121 -0
  116. package/dist/artifacts/21-portable-agentic-system/task.md +115 -0
  117. package/dist/artifacts/22-standardize-phase-0-artifact/architect/analysis.md +113 -0
  118. package/dist/artifacts/22-standardize-phase-0-artifact/architect/plan.md +124 -0
  119. package/dist/artifacts/22-standardize-phase-0-artifact/researcher/research.md +76 -0
  120. package/dist/artifacts/22-standardize-phase-0-artifact/results.md +36 -0
  121. package/dist/artifacts/22-standardize-phase-0-artifact/task.md +115 -0
  122. package/dist/artifacts/22-standardize-phase-0-artifact/verification.md +41 -0
  123. package/dist/artifacts/23-auditoria-de-indexes-y-alias/acceptance.md +62 -0
  124. package/dist/artifacts/23-auditoria-de-indexes-y-alias/architect/analysis.md +90 -0
  125. package/dist/artifacts/23-auditoria-de-indexes-y-alias/architect/plan.md +85 -0
  126. package/dist/artifacts/23-auditoria-de-indexes-y-alias/audit-report.md +52 -0
  127. package/dist/artifacts/23-auditoria-de-indexes-y-alias/researcher/research.md +52 -0
  128. package/dist/artifacts/23-auditoria-de-indexes-y-alias/results.md +31 -0
  129. package/dist/artifacts/23-auditoria-de-indexes-y-alias/task.md +90 -0
  130. package/dist/artifacts/23-auditoria-de-indexes-y-alias/verification.md +42 -0
  131. package/dist/artifacts/24-revision-priorizacion-todo-backlog/analysis.md +64 -0
  132. package/dist/artifacts/24-revision-priorizacion-todo-backlog/candidate/acceptance.md +68 -0
  133. package/dist/artifacts/24-revision-priorizacion-todo-backlog/planning.md +79 -0
  134. package/dist/artifacts/24-revision-priorizacion-todo-backlog/portable-roadmap.md +25 -0
  135. package/dist/artifacts/24-revision-priorizacion-todo-backlog/researcher/research.md +91 -0
  136. package/dist/artifacts/24-revision-priorizacion-todo-backlog/task.md +89 -0
  137. package/dist/artifacts/24-revision-priorizacion-todo-backlog/verification.md +59 -0
  138. package/dist/artifacts/25-auditoria-omision-gates/acceptance.md +57 -0
  139. package/dist/artifacts/25-auditoria-omision-gates/brief.md +89 -0
  140. package/dist/artifacts/25-auditoria-omision-gates/closure.md +88 -0
  141. package/dist/artifacts/25-auditoria-omision-gates/rca.md +49 -0
  142. package/dist/artifacts/25-auditoria-omision-gates/task.md +64 -0
  143. package/dist/artifacts/26-portable-agentic-system/acceptance.md +41 -0
  144. package/dist/artifacts/26-portable-agentic-system/agent-tasks/1-architect-scaffolding.md +113 -0
  145. package/dist/artifacts/26-portable-agentic-system/agent-tasks/2-architect-core-migration.md +117 -0
  146. package/dist/artifacts/26-portable-agentic-system/agent-tasks/3-architect-cli-implementation.md +109 -0
  147. package/dist/artifacts/26-portable-agentic-system/agent-tasks/4-architect-linking-and-verification.md +104 -0
  148. package/dist/artifacts/26-portable-agentic-system/analysis.md +117 -0
  149. package/dist/artifacts/26-portable-agentic-system/architect/review.md +41 -0
  150. package/dist/artifacts/26-portable-agentic-system/plan.md +146 -0
  151. package/dist/artifacts/26-portable-agentic-system/researcher/research.md +96 -0
  152. package/dist/artifacts/26-portable-agentic-system/task.md +50 -0
  153. package/dist/artifacts/26-portable-agentic-system/verification.md +67 -0
  154. package/dist/artifacts/27-update-portable-module-agent-identity/acceptance.md +74 -0
  155. package/dist/artifacts/27-update-portable-module-agent-identity/agent-tasks/1-module-agent-update-templates.md +86 -0
  156. package/dist/artifacts/27-update-portable-module-agent-identity/agent-tasks/2-module-agent-update-workflows-long.md +88 -0
  157. package/dist/artifacts/27-update-portable-module-agent-identity/agent-tasks/3-module-agent-update-workflows-short-init.md +89 -0
  158. package/dist/artifacts/27-update-portable-module-agent-identity/agent-tasks/4-module-agent-update-roles.md +85 -0
  159. package/dist/artifacts/27-update-portable-module-agent-identity/agent-tasks/5-module-agent-update-version-manifests.md +84 -0
  160. package/dist/artifacts/27-update-portable-module-agent-identity/analysis.md +90 -0
  161. package/dist/artifacts/27-update-portable-module-agent-identity/architect/review.md +44 -0
  162. package/dist/artifacts/27-update-portable-module-agent-identity/changelog.md +17 -0
  163. package/dist/artifacts/27-update-portable-module-agent-identity/metrics.md +52 -0
  164. package/dist/artifacts/27-update-portable-module-agent-identity/plan.md +122 -0
  165. package/dist/artifacts/27-update-portable-module-agent-identity/researcher/research.md +73 -0
  166. package/dist/artifacts/27-update-portable-module-agent-identity/results-acceptance.md +51 -0
  167. package/dist/artifacts/27-update-portable-module-agent-identity/task.md +115 -0
  168. package/dist/artifacts/27-update-portable-module-agent-identity/verification.md +66 -0
  169. package/dist/artifacts/28-agent-system-update-conversion/acceptance.md +67 -0
  170. package/dist/artifacts/28-agent-system-update-conversion/agent-tasks/1-tooling-agent-migration-infrastructure.md +88 -0
  171. package/dist/artifacts/28-agent-system-update-conversion/agent-tasks/2-tooling-agent-content-transformer.md +87 -0
  172. package/dist/artifacts/28-agent-system-update-conversion/agent-tasks/3-tooling-agent-cli-wizard-integration.md +86 -0
  173. package/dist/artifacts/28-agent-system-update-conversion/analysis.md +153 -0
  174. package/dist/artifacts/28-agent-system-update-conversion/architect/review.md +93 -0
  175. package/dist/artifacts/28-agent-system-update-conversion/metrics.md +43 -0
  176. package/dist/artifacts/28-agent-system-update-conversion/plan.md +153 -0
  177. package/dist/artifacts/28-agent-system-update-conversion/researcher/research.md +66 -0
  178. package/dist/artifacts/28-agent-system-update-conversion/results-acceptance.md +125 -0
  179. package/dist/artifacts/28-agent-system-update-conversion/task.md +103 -0
  180. package/dist/artifacts/28-agent-system-update-conversion/verification.md +60 -0
  181. package/dist/artifacts/29-agentic-framework-core-reference-refactor/acceptance.md +38 -0
  182. package/dist/artifacts/29-agentic-framework-core-reference-refactor/agent-tasks/1-tooling-agent-core-resolver.md +85 -0
  183. package/dist/artifacts/29-agentic-framework-core-reference-refactor/agent-tasks/2-tooling-agent-init-refactor.md +90 -0
  184. package/dist/artifacts/29-agentic-framework-core-reference-refactor/agent-tasks/3-tooling-agent-scaffolding-system.md +92 -0
  185. package/dist/artifacts/29-agentic-framework-core-reference-refactor/agent-tasks/4-architect-agents-md-trail.md +84 -0
  186. package/dist/artifacts/29-agentic-framework-core-reference-refactor/agent-tasks/5-tooling-agent-mcp-server.md +92 -0
  187. package/dist/artifacts/29-agentic-framework-core-reference-refactor/agent-tasks/6-architect-neo-agent-birth.md +85 -0
  188. package/dist/artifacts/29-agentic-framework-core-reference-refactor/analysis.md +119 -0
  189. package/dist/artifacts/29-agentic-framework-core-reference-refactor/architect/review.md +46 -0
  190. package/dist/artifacts/29-agentic-framework-core-reference-refactor/plan.md +95 -0
  191. package/dist/artifacts/29-agentic-framework-core-reference-refactor/researcher/research.md +68 -0
  192. package/dist/artifacts/29-agentic-framework-core-reference-refactor/results-acceptance.md +59 -0
  193. package/dist/artifacts/29-agentic-framework-core-reference-refactor/task.md +99 -0
  194. package/dist/artifacts/29-agentic-framework-core-reference-refactor/verification.md +54 -0
  195. package/dist/artifacts/3-developer-feedback-gate/acceptance-criteria.md +18 -0
  196. package/dist/artifacts/3-developer-feedback-gate/analysis.md +27 -0
  197. package/dist/artifacts/3-developer-feedback-gate/changelog.md +10 -0
  198. package/dist/artifacts/3-developer-feedback-gate/implementation_plan.md +32 -0
  199. package/dist/artifacts/3-developer-feedback-gate/init.md +13 -0
  200. package/dist/artifacts/3-developer-feedback-gate/metrics.md +34 -0
  201. package/dist/artifacts/3-developer-feedback-gate/research.md +28 -0
  202. package/dist/artifacts/3-developer-feedback-gate/results-acceptance.md +17 -0
  203. package/dist/artifacts/3-developer-feedback-gate/task.md +17 -0
  204. package/dist/artifacts/3-developer-feedback-gate/verification.md +35 -0
  205. package/dist/artifacts/30-task-execution-protocol-gates/acceptance.md +46 -0
  206. package/dist/artifacts/30-task-execution-protocol-gates/researcher/research.md +34 -0
  207. package/dist/artifacts/30-task-execution-protocol-gates/task.md +77 -0
  208. package/dist/artifacts/4-adr-workflows-modulos/adr.md +380 -0
  209. package/dist/artifacts/4-adr-workflows-modulos/analysis.md +353 -0
  210. package/dist/artifacts/4-adr-workflows-modulos/plan.md +301 -0
  211. package/dist/artifacts/4-adr-workflows-modulos/researcher/research.md +253 -0
  212. package/dist/artifacts/4-adr-workflows-modulos/results.md +202 -0
  213. package/dist/artifacts/4-adr-workflows-modulos/task.md +143 -0
  214. package/dist/artifacts/4-adr-workflows-modulos/verification.md +123 -0
  215. package/dist/artifacts/5-implementar-adr-crear-modulo/analysis.md +169 -0
  216. package/dist/artifacts/5-implementar-adr-crear-modulo/architect/review.md +105 -0
  217. package/dist/artifacts/5-implementar-adr-crear-modulo/architect/subtask-implementation.md +90 -0
  218. package/dist/artifacts/5-implementar-adr-crear-modulo/changelog.md +7 -0
  219. package/dist/artifacts/5-implementar-adr-crear-modulo/metrics.md +34 -0
  220. package/dist/artifacts/5-implementar-adr-crear-modulo/plan.md +163 -0
  221. package/dist/artifacts/5-implementar-adr-crear-modulo/researcher/research.md +105 -0
  222. package/dist/artifacts/5-implementar-adr-crear-modulo/results-acceptance.md +153 -0
  223. package/dist/artifacts/5-implementar-adr-crear-modulo/task.md +147 -0
  224. package/dist/artifacts/5-implementar-adr-crear-modulo/verification.md +79 -0
  225. package/dist/artifacts/6-exportar-ciclo-agent-zip/analysis.md +153 -0
  226. package/dist/artifacts/6-exportar-ciclo-agent-zip/architect/review.md +103 -0
  227. package/dist/artifacts/6-exportar-ciclo-agent-zip/architect/subtask-implementation.md +79 -0
  228. package/dist/artifacts/6-exportar-ciclo-agent-zip/changelog.md +8 -0
  229. package/dist/artifacts/6-exportar-ciclo-agent-zip/metrics.md +34 -0
  230. package/dist/artifacts/6-exportar-ciclo-agent-zip/plan.md +131 -0
  231. package/dist/artifacts/6-exportar-ciclo-agent-zip/researcher/research.md +86 -0
  232. package/dist/artifacts/6-exportar-ciclo-agent-zip/results-acceptance.md +108 -0
  233. package/dist/artifacts/6-exportar-ciclo-agent-zip/task.md +147 -0
  234. package/dist/artifacts/6-exportar-ciclo-agent-zip/verification.md +74 -0
  235. package/dist/artifacts/6-exportar-ciclo-agent-zip/whitelist.txt +33 -0
  236. package/dist/artifacts/7-modules-globals-constants/analysis.md +205 -0
  237. package/dist/artifacts/7-modules-globals-constants/architect/review.md +110 -0
  238. package/dist/artifacts/7-modules-globals-constants/metrics.md +45 -0
  239. package/dist/artifacts/7-modules-globals-constants/plan.md +276 -0
  240. package/dist/artifacts/7-modules-globals-constants/researcher/research.md +247 -0
  241. package/dist/artifacts/7-modules-globals-constants/task.md +112 -0
  242. package/dist/artifacts/7-modules-globals-constants/verification.md +76 -0
  243. package/dist/artifacts/8-module-workflow-refactor/analysis.md +131 -0
  244. package/dist/artifacts/8-module-workflow-refactor/changelog.md +24 -0
  245. package/dist/artifacts/8-module-workflow-refactor/metrics.md +37 -0
  246. package/dist/artifacts/8-module-workflow-refactor/plan.md +193 -0
  247. package/dist/artifacts/8-module-workflow-refactor/researcher/research.md +222 -0
  248. package/dist/artifacts/8-module-workflow-refactor/results.md +112 -0
  249. package/dist/artifacts/8-module-workflow-refactor/review.md +76 -0
  250. package/dist/artifacts/8-module-workflow-refactor/task.md +154 -0
  251. package/dist/artifacts/8-module-workflow-refactor/verification.md +76 -0
  252. package/dist/artifacts/8-module-workflow-refactor/walkthrough.md +64 -0
  253. package/dist/artifacts/9-build-stabilization/analysis.md +62 -0
  254. package/dist/artifacts/9-build-stabilization/metrics.md +11 -0
  255. package/dist/artifacts/9-build-stabilization/plan.md +82 -0
  256. package/dist/artifacts/9-build-stabilization/researcher/research.md +102 -0
  257. package/dist/artifacts/9-build-stabilization/task.md +23 -0
  258. package/dist/artifacts/9-build-stabilization/walkthrough.md +56 -0
  259. package/dist/artifacts/candidate/init.md +34 -0
  260. package/dist/artifacts/candidate/task.md +24 -0
  261. package/dist/artifacts/index.md +31 -10
  262. package/dist/cli/commands/init.js +31 -137
  263. package/dist/cli/commands/restore.js +4 -11
  264. package/dist/core/migration/backup.js +2 -3
  265. package/dist/core/utils/backup.js +3 -24
  266. package/dist/index.md +57 -0
  267. package/dist/metrics/agent-scores.md +30 -0
  268. package/dist/metrics/agents.json +106 -0
  269. package/dist/metrics/index.md +23 -0
  270. package/dist/rules/constitution/GEMINI.location.md +17 -14
  271. package/dist/rules/constitution/agents-behavior.md +111 -107
  272. package/dist/rules/constitution/clean-code.md +65 -13
  273. package/dist/rules/constitution/drivers.md +294 -0
  274. package/dist/rules/constitution/extensio-architecture.md +131 -0
  275. package/dist/rules/constitution/index.md +20 -17
  276. package/dist/rules/constitution/modules.md +280 -0
  277. package/dist/rules/constitution/pages.md +454 -0
  278. package/dist/rules/constitution/shards.md +484 -0
  279. package/dist/rules/index.md +57 -12
  280. package/dist/rules/roles/architect.md +128 -28
  281. package/dist/rules/roles/driver.md +172 -0
  282. package/dist/rules/roles/index.md +20 -18
  283. package/dist/rules/roles/module.md +175 -0
  284. package/dist/rules/roles/neo.md +6 -18
  285. package/dist/rules/roles/qa.md +195 -8
  286. package/dist/rules/roles/researcher.md +75 -10
  287. package/dist/rules/roles/surface.md +60 -0
  288. package/dist/rules/roles/tooling.md +55 -9
  289. package/dist/skills/extensio-build/SKILL.md +161 -0
  290. package/dist/skills/extensio-create-driver/SKILL.md +89 -0
  291. package/dist/skills/extensio-create-module/SKILL.md +91 -0
  292. package/dist/skills/extensio-demo/SKILL.md +84 -0
  293. package/dist/skills/extensio-test/SKILL.md +96 -0
  294. package/dist/skills/extensio-validate-code/SKILL.md +262 -0
  295. package/dist/skills/index.md +79 -0
  296. package/dist/templates/acceptance.md +20 -20
  297. package/dist/templates/agent-scores.md +7 -11
  298. package/dist/templates/agent-task.md +60 -63
  299. package/dist/templates/analysis.md +92 -92
  300. package/dist/templates/brief.md +49 -49
  301. package/dist/templates/changelog.md +8 -12
  302. package/dist/templates/closure.md +28 -28
  303. package/dist/templates/driver-create.md +116 -0
  304. package/dist/templates/driver-delete.md +84 -0
  305. package/dist/templates/driver-refactor.md +94 -0
  306. package/dist/templates/index.md +14 -11
  307. package/dist/templates/init.md +0 -12
  308. package/dist/templates/module-create.md +117 -0
  309. package/dist/templates/module-delete.md +79 -0
  310. package/dist/templates/module-refactor.md +87 -0
  311. package/dist/templates/planning.md +76 -78
  312. package/dist/templates/research.md +44 -56
  313. package/dist/templates/results-acceptance.md +94 -106
  314. package/dist/templates/review.md +61 -62
  315. package/dist/templates/subtask-implementation.md +30 -35
  316. package/dist/templates/supplemental-report.md +8 -12
  317. package/dist/templates/task-metrics.md +14 -15
  318. package/dist/templates/task.md +15 -19
  319. package/dist/templates/todo-item.md +23 -27
  320. package/dist/templates/verification.md +33 -33
  321. package/dist/todo/001-anadir-seccion-reasoning.md +42 -0
  322. package/dist/todo/002-anadir-ejemplos-few-shot.md +46 -0
  323. package/dist/todo/003-explorar-paralelizacion-phase4.md +46 -0
  324. package/dist/todo/004-portable-agentic-system.md +44 -0
  325. package/dist/todo/README.md +58 -0
  326. package/dist/todo/index.md +27 -0
  327. package/dist/tools/extensio-cli.md +76 -0
  328. package/dist/tools/index.md +14 -0
  329. package/dist/tools/run-command.md +42 -0
  330. package/dist/workflows/drivers/create.md +139 -0
  331. package/dist/workflows/drivers/delete.md +124 -0
  332. package/dist/workflows/drivers/index.md +25 -0
  333. package/dist/workflows/drivers/refactor.md +125 -0
  334. package/dist/workflows/index.md +17 -29
  335. package/dist/workflows/init.md +103 -43
  336. package/dist/workflows/modules/create.md +160 -0
  337. package/dist/workflows/modules/delete.md +121 -0
  338. package/dist/workflows/modules/index.md +27 -0
  339. package/dist/workflows/modules/pages.create.md +234 -0
  340. package/dist/workflows/modules/refactor.md +122 -0
  341. package/dist/workflows/modules/shards.create.md +215 -0
  342. package/dist/workflows/tasklifecycle-long/index.md +86 -90
  343. package/dist/workflows/tasklifecycle-long/phase-0-acceptance-criteria.md +130 -118
  344. package/dist/workflows/tasklifecycle-long/phase-1-research.md +104 -105
  345. package/dist/workflows/tasklifecycle-long/phase-2-analysis.md +120 -97
  346. package/dist/workflows/tasklifecycle-long/phase-3-planning.md +136 -75
  347. package/dist/workflows/tasklifecycle-long/phase-4-implementation.md +163 -73
  348. package/dist/workflows/tasklifecycle-long/phase-5-verification.md +136 -45
  349. package/dist/workflows/tasklifecycle-long/phase-6-results-acceptance.md +106 -46
  350. package/dist/workflows/tasklifecycle-long/phase-7-evaluation.md +96 -51
  351. package/dist/workflows/tasklifecycle-long/phase-8-commit-push.md +108 -51
  352. package/dist/workflows/tasklifecycle-short/index.md +30 -27
  353. package/dist/workflows/tasklifecycle-short/short-phase-1-brief.md +80 -39
  354. package/dist/workflows/tasklifecycle-short/short-phase-2-implementation.md +78 -44
  355. package/dist/workflows/tasklifecycle-short/short-phase-3-closure.md +81 -44
  356. package/package.json +3 -3
  357. package/dist/bootstrap.md +0 -591
  358. package/dist/rules/constitution/agent-system.md +0 -77
  359. package/dist/rules/constitution/project-architecture.md +0 -57
@@ -0,0 +1,387 @@
1
+ ---
2
+ artifact: plan
3
+ phase: phase-3-planning
4
+ owner: architect-agent
5
+ status: draft
6
+ related_task: 12-adaptacion-core-cli-surfaces
7
+ ---
8
+
9
+ # Implementation Plan — 12-adaptacion-core-cli-surfaces
10
+
11
+ ## 1. Resumen del plan
12
+
13
+ - **Contexto**: Adaptar Core y CLI para cumplir con las constituciones de Pages y Shards. Incluye cambio arquitectónico aprobado: Page como controller sin render, con capacidad de cargar Shards.
14
+
15
+ - **Resultado esperado**:
16
+ - `Surface` con lifecycle hooks (`onMount`, `onUnmount`)
17
+ - `Shard` heredando de `Surface` (no de `Core`)
18
+ - `Page` como controller con `loadShard()`, sin render
19
+ - Generadores CLI independientes para `page` y `shard`
20
+ - Demo funcional con E2E en 3 navegadores
21
+
22
+ - **Alcance**:
23
+ - ✅ Incluye: Core (Surface, Page, Shard), CLI (generadores), Demo, Tests
24
+ - ❌ Excluye: Otros componentes visuales, drivers, módulos existentes
25
+
26
+ ---
27
+
28
+ ## 2. Inputs contractuales
29
+
30
+ - **Task**: `.agent/artifacts/12-adaptacion-core-cli-surfaces/task.md`
31
+ - **Analysis**: `.agent/artifacts/12-adaptacion-core-cli-surfaces/analysis.md`
32
+ - **Architecture Change**: `.agent/artifacts/12-adaptacion-core-cli-surfaces/analysis-architecture-change.md`
33
+ - **Acceptance Criteria**: AC 1-7 definidos en task.md
34
+
35
+ **Dispatch de dominios**
36
+
37
+ ```yaml
38
+ plan:
39
+ workflows:
40
+ core:
41
+ action: refactor
42
+ workflow: null # No existe workflow específico, implementación directa
43
+ cli:
44
+ action: create
45
+ workflow: null # Implementación directa siguiendo patrón de driver generator
46
+
47
+ dispatch:
48
+ - domain: core
49
+ action: refactor
50
+ agent: surface-agent
51
+ - domain: cli
52
+ action: create
53
+ agent: architect-agent
54
+ - domain: qa
55
+ action: verify
56
+ agent: qa-agent
57
+ ```
58
+
59
+ ---
60
+
61
+ ## 3. Desglose de implementación (pasos)
62
+
63
+ ### Paso 1: Refactorizar Surface
64
+ - **Descripción**: Corregir ciclo de vida de `Surface`. `onMount()` debe ejecutarse DESPUÉS de `render()`, no llamar a `run()`.
65
+ - **Dependencias**: Ninguna
66
+ - **Entregables**: `packages/core/src/surface/surface.mts` actualizado
67
+ - **Agente responsable**: surface-agent
68
+
69
+ **Cambios específicos**:
70
+ ```typescript
71
+ // Antes
72
+ onMount(): void {
73
+ this.run(); // ❌ Incorrecto
74
+ }
75
+
76
+ // Después
77
+ onMount(): void {
78
+ // Hook para subclases, no inicia ciclo
79
+ }
80
+ ```
81
+
82
+ ### Paso 2: Migrar Shard para heredar de Surface
83
+ - **Descripción**: Cambiar `extends Core` → `extends Surface`. Mover lógica duplicada a Surface si aplica.
84
+ - **Dependencias**: Paso 1 completado
85
+ - **Entregables**: `packages/core/src/surface/shards/index.mts` actualizado
86
+ - **Agente responsable**: surface-agent
87
+
88
+ **Cambios específicos**:
89
+ ```typescript
90
+ // Antes
91
+ export abstract class Shard extends Core implements ShardLifecycle { ... }
92
+
93
+ // Después
94
+ export abstract class Shard extends Surface implements ShardLifecycle { ... }
95
+ ```
96
+
97
+ ### Paso 3: Implementar Page como controller
98
+ - **Descripción**: Añadir `loadShard()`, `unloadShard()`, `getShards()` a Page. Gestionar cleanup en `onUnmount()`.
99
+ - **Dependencias**: Paso 1 completado
100
+ - **Entregables**: `packages/core/src/surface/pages/index.mts` actualizado
101
+ - **Agente responsable**: surface-agent
102
+
103
+ **Cambios específicos** (según analysis-architecture-change.md):
104
+ ```typescript
105
+ export class Page extends Surface {
106
+ private _shards: Map<string, Shard> = new Map();
107
+
108
+ public async loadShard<T extends Shard>(
109
+ ShardClass: new (context: ShardContext) => T,
110
+ options?: PageShardOptions
111
+ ): Promise<T> { ... }
112
+
113
+ public unloadShard(shardId: string): void { ... }
114
+ public getShards(): Shard[] { ... }
115
+
116
+ protected override onUnmount(): void {
117
+ // Cleanup all shards
118
+ }
119
+ }
120
+ ```
121
+
122
+ ### Paso 4: Actualizar exports en package.json
123
+ - **Descripción**: Añadir export para Surface base si falta, verificar consistencia.
124
+ - **Dependencias**: Pasos 1-3 completados
125
+ - **Entregables**: `packages/core/package.json` actualizado
126
+ - **Agente responsable**: surface-agent
127
+
128
+ ### Paso 5: Crear generador CLI para Page
129
+ - **Descripción**: Crear generador independiente que añada Page a módulo existente.
130
+ - **Dependencias**: Paso 3 completado (para template correcto)
131
+ - **Entregables**: `packages/cli/src/generators/page/` creado
132
+ - **Agente responsable**: architect-agent
133
+ - **Tool**: Implementación manual siguiendo patrón de `generators/driver/`
134
+
135
+ ### Paso 6: Crear generador CLI para Shard
136
+ - **Descripción**: Crear generador independiente que añada Shard a módulo existente.
137
+ - **Dependencias**: Paso 2 completado
138
+ - **Entregables**: `packages/cli/src/generators/shard/` creado
139
+ - **Agente responsable**: architect-agent
140
+ - **Tool**: Implementación manual siguiendo patrón de `generators/driver/`
141
+
142
+ ### Paso 7: Reconstruir Demo
143
+ - **Descripción**: Eliminar demo actual, crear nueva con CLI que demuestre Page cargando Shards.
144
+ - **Dependencias**: Pasos 1-6 completados
145
+ - **Entregables**: `packages/core/demo/` reconstruida
146
+ - **Agente responsable**: surface-agent
147
+ - **Tool**: `mcp_extensio-cli extensio_create` con `type: module`, `--withPage`, `--withShard`
148
+
149
+ ### Paso 8: Tests unitarios
150
+ - **Descripción**: Tests para Surface, Page, Shard (herencia, lifecycle, loadShard)
151
+ - **Dependencias**: Pasos 1-4 completados
152
+ - **Entregables**: Tests en `packages/core/test/`
153
+ - **Agente responsable**: qa-agent
154
+ - **Tool**: `mcp_extensio-cli extensio_test` con `type: unit`
155
+
156
+ ### Paso 9: Tests E2E
157
+ - **Descripción**: Validar demo en Chrome, Firefox, Safari
158
+ - **Dependencias**: Pasos 7-8 completados
159
+ - **Entregables**: Tests E2E pasando en 3 navegadores
160
+ - **Agente responsable**: qa-agent
161
+ - **Tool**: `mcp_extensio-cli extensio_test` con `type: e2e`, `browsers: chromium,firefox,safari`
162
+
163
+ ---
164
+
165
+ ## 4. Asignación de responsabilidades (Agentes)
166
+
167
+ ### architect-agent
168
+ - Supervisión de gates y conformidad arquitectónica
169
+ - Implementación de generadores CLI (Pasos 5-6)
170
+ - Revisión final antes de cada gate
171
+
172
+ ### surface-agent (delegado)
173
+ - Refactorización de Core (Pasos 1-4)
174
+ - Reconstrucción de Demo (Paso 7)
175
+ - Verificación de conformidad con constituciones
176
+
177
+ ### qa-agent
178
+ - Diseño y ejecución de tests unitarios (Paso 8)
179
+ - Diseño y ejecución de tests E2E (Paso 9)
180
+ - Reporte de cobertura
181
+
182
+ ### Handoffs
183
+ 1. **architect → surface-agent**: Plan aprobado, iniciar Paso 1
184
+ 2. **surface-agent → qa-agent**: Pasos 1-4 completados, iniciar tests unitarios
185
+ 3. **surface-agent → architect**: Paso 7 completado (demo), revisar
186
+ 4. **qa-agent → architect**: Tests pasando, gate de verificación
187
+
188
+ ### Componentes
189
+
190
+ | Componente | Quién | Cómo | Tool |
191
+ |------------|-------|------|------|
192
+ | Surface refactor | surface-agent | Edición directa | Editor |
193
+ | Shard migration | surface-agent | Cambiar herencia | Editor |
194
+ | Page controller | surface-agent | Implementar loadShard | Editor |
195
+ | Generador page | architect-agent | Crear directorio + index.mts | Editor (patrón driver) |
196
+ | Generador shard | architect-agent | Crear directorio + index.mts | Editor (patrón driver) |
197
+ | Demo | surface-agent | Recrear | `mcp_extensio-cli extensio_create` |
198
+
199
+ ### Demo
200
+
201
+ - **Estructura esperada** (alineada con `constitution.extensio_architecture`):
202
+ ```
203
+ packages/core/demo/
204
+ ├── src/
205
+ │ ├── engine/
206
+ │ │ └── index.mts
207
+ │ ├── surface/
208
+ │ │ ├── pages/
209
+ │ │ │ ├── index.mts
210
+ │ │ │ └── main/
211
+ │ │ │ ├── index.html
212
+ │ │ │ └── index.mts
213
+ │ │ └── shards/
214
+ │ │ ├── index.mts
215
+ │ │ └── example/
216
+ │ │ └── index.mts
217
+ │ └── manifest.json
218
+ ├── test/
219
+ │ └── e2e/
220
+ ├── package.json
221
+ └── tsconfig.json
222
+ ```
223
+ - **Tool obligatorio**: `mcp_extensio-cli extensio_create`
224
+
225
+ ---
226
+
227
+ ## 5. Estrategia de testing y validación
228
+
229
+ ### Unit tests (Vitest)
230
+ - **Alcance**:
231
+ - Surface: lifecycle hooks order
232
+ - Shard: hereda de Surface, métodos abstractos
233
+ - Page: loadShard, unloadShard, getShards, cleanup en onUnmount
234
+ - **Herramienta**: Vitest (según `constitution.extensio_architecture`)
235
+ - **Comando**: `npm run test` o `mcp_extensio-cli extensio_test --type unit`
236
+
237
+ ### E2E tests (Playwright)
238
+ - **Flujos cubiertos**:
239
+ - Extension carga en Chrome/Firefox/Safari
240
+ - Service Worker activo
241
+ - Page navega correctamente
242
+ - Shard se monta en Page
243
+ - Comunicación Engine ↔ Page ↔ Shard
244
+ - **Herramienta**: Playwright (según `constitution.extensio_architecture`)
245
+ - **Comando**: `mcp_extensio-cli extensio_test --type e2e --browsers chromium,firefox,safari`
246
+
247
+ ### Trazabilidad
248
+
249
+ | Test | AC |
250
+ |------|----|
251
+ | Surface lifecycle test | AC-1 |
252
+ | Page inherits Surface test | AC-2 |
253
+ | Shard inherits Surface test | AC-3 |
254
+ | Page.loadShard test | AC-2, AC-6 |
255
+ | CLI page generator test | AC-4 |
256
+ | CLI shard generator test | AC-5 |
257
+ | Demo E2E Chrome | AC-6, AC-7 |
258
+ | Demo E2E Firefox | AC-7 |
259
+ | Demo E2E Safari | AC-7 |
260
+
261
+ ---
262
+
263
+ ## 6. Plan de demo
264
+
265
+ - **Objetivo**: Demostrar que Page actúa como controller cargando Shards, sin render propio.
266
+ - **Escenarios**:
267
+ 1. Extension carga, Engine inicia
268
+ 2. Navegar a Page desde popup
269
+ 3. Page carga 2 Shards dinámicamente
270
+ 4. Shards renderizan contenido
271
+ 5. Cerrar Page → Shards se desmontan (onUnmount)
272
+ - **Datos de ejemplo**: Shards mostrarán datos mock
273
+ - **Criterios de éxito**:
274
+ - Build sin errores para Chrome, Firefox, Safari
275
+ - E2E tests pasan en 3 navegadores
276
+ - No errores en consola
277
+
278
+ ---
279
+
280
+ ## 7. Estimaciones y pesos de implementación
281
+
282
+ | Paso | Descripción | Esfuerzo | Dependencia |
283
+ |------|-------------|----------|-------------|
284
+ | 1 | Refactorizar Surface | Bajo | - |
285
+ | 2 | Migrar Shard → Surface | Medio | 1 |
286
+ | 3 | Page como controller | Medio | 1 |
287
+ | 4 | Actualizar exports | Bajo | 1-3 |
288
+ | 5 | Generador page CLI | Medio | 3 |
289
+ | 6 | Generador shard CLI | Medio | 2 |
290
+ | 7 | Reconstruir demo | Medio | 1-6 |
291
+ | 8 | Tests unitarios | Medio | 1-4 |
292
+ | 9 | Tests E2E | Alto | 7-8 |
293
+
294
+ **Timeline aproximado**: 1-2 sesiones de trabajo
295
+
296
+ **Suposiciones**:
297
+ - No hay dependencias circulares en código existente
298
+ - Playwright ya está configurado
299
+ - Vitest ya está configurado
300
+
301
+ ---
302
+
303
+ ## 8. Puntos críticos y resolución
304
+
305
+ ### Punto crítico 1: Breaking change en Shard
306
+ - **Riesgo**: Módulos existentes que usan Shard pueden romperse
307
+ - **Impacto**: Alto
308
+ - **Resolución**:
309
+ - Mantener API pública idéntica
310
+ - Solo cambiar herencia interna (Core → Surface)
311
+ - Verificar demos de módulos existentes después del cambio
312
+
313
+ ### Punto crítico 2: onMount timing
314
+ - **Riesgo**: Cambiar cuándo se ejecuta onMount puede romper código existente
315
+ - **Impacto**: Medio
316
+ - **Resolución**:
317
+ - Documentar claramente el nuevo comportamiento
318
+ - Añadir logs de deprecación si se detecta uso incorrecto
319
+ - Tests exhaustivos de lifecycle
320
+
321
+ ### Punto crítico 3: Safari compatibility
322
+ - **Riesgo**: Webkit puede comportarse diferente
323
+ - **Impacto**: Medio
324
+ - **Resolución**:
325
+ - Tests E2E específicos para webkit
326
+ - Verificar comportamiento de customElements en Safari
327
+
328
+ ---
329
+
330
+ ## 9. Dependencias y compatibilidad
331
+
332
+ ### Dependencias internas
333
+ - `@extensio/core` → base
334
+ - `@extensio/driver-storage` → reactividad
335
+ - `@extensio/driver-runtime` → comunicación
336
+
337
+ ### Dependencias externas
338
+ - Lit (opcional, para Shards)
339
+ - Vitest (testing)
340
+ - Playwright (E2E)
341
+
342
+ ### Compatibilidad entre navegadores
343
+ | Feature | Chrome | Firefox | Safari |
344
+ |---------|--------|---------|--------|
345
+ | Service Worker | ✅ | ✅ | ✅ |
346
+ | customElements | ✅ | ✅ | ✅ |
347
+ | Storage API | ✅ | ✅ | ✅ |
348
+ | Scripting API | ✅ | ✅ | ✅ |
349
+
350
+ ### Restricciones arquitectónicas
351
+ - Surface DEBE ser clase abstracta
352
+ - Page NO renderiza (solo carga Shards)
353
+ - Shard DEBE heredar de Surface
354
+
355
+ ---
356
+
357
+ ## 10. Criterios de finalización
358
+
359
+ ### Checklist final
360
+
361
+ - [ ] Surface con hooks `onMount()`, `onUnmount()` ejecutándose en momento correcto
362
+ - [ ] Shard hereda de Surface (no Core)
363
+ - [ ] Page hereda de Surface con `loadShard()`, `unloadShard()`, `getShards()`
364
+ - [ ] Page NO tiene método render (solo Shards renderizan)
365
+ - [ ] Exports actualizados en package.json
366
+ - [ ] Generador `extensio create page` funcional
367
+ - [ ] Generador `extensio create shard` funcional
368
+ - [ ] Demo reconstruida con CLI
369
+ - [ ] Tests unitarios pasan
370
+ - [ ] Tests E2E pasan en Chrome
371
+ - [ ] Tests E2E pasan en Firefox
372
+ - [ ] Tests E2E pasan en Safari
373
+ - [ ] Build sin errores para 3 navegadores
374
+
375
+ ---
376
+
377
+ ## 11. Aprobación del desarrollador (OBLIGATORIA)
378
+
379
+ Este plan **requiere aprobación explícita y binaria**.
380
+
381
+ ```yaml
382
+ approval:
383
+ developer:
384
+ decision: SI
385
+ date: 2026-01-14T08:07:44+01:00
386
+ comments: Aprobado para implementación
387
+ ```
@@ -0,0 +1,266 @@
1
+ ---
2
+ artifact: research
3
+ phase: phase-1-research
4
+ owner: researcher-agent
5
+ status: draft
6
+ related_task: 12-adaptacion-core-cli-surfaces
7
+ ---
8
+
9
+ # Research Report — 12-adaptacion-core-cli-surfaces
10
+
11
+ ## 1. Resumen ejecutivo
12
+
13
+ ### Problema investigado
14
+ Verificar qué cambios son necesarios en `@extensio/core` y `extensio-cli` para que la implementación actual esté alineada con las constituciones de Pages y Shards (Surfaces v2.0).
15
+
16
+ ### Objetivo
17
+ Identificar gaps entre la implementación actual y las constituciones, proponer orden de implementación y estimar impacto.
18
+
19
+ ### Principales hallazgos
20
+
21
+ | Área | Gap Crítico | Severidad |
22
+ |------|------------|-----------|
23
+ | **Core: Shard** | Hereda de `Core`, no de `Surface` | 🔴 HIGH |
24
+ | **Core: Page** | Implementación mínima (9 líneas) | 🟡 MEDIUM |
25
+ | **Core: Surface** | Falta ciclo de vida completo | 🟡 MEDIUM |
26
+ | **CLI: Comandos** | No existen `create page` / `create shard` | 🔴 HIGH |
27
+ | **CLI: Templates** | Desactualizados vs constitución | 🟡 MEDIUM |
28
+ | **Demo** | Incompleta, solo `manifest.json` | 🔴 HIGH |
29
+
30
+ ---
31
+
32
+ ## 2. Necesidades detectadas
33
+
34
+ ### 2.1 Desde constitución Pages (v2.1.0)
35
+ - Page DEBE heredar de Surface → Core
36
+ - Page DEBE tener hooks `onMount()`, `onUnmount()` heredados de Surface
37
+ - Page DEBE seguir ciclo: `run()` → `_setup()` → `listen()` → `loadProps()` → `start()` → `render()` → `onMount()`
38
+ - Page se navega mediante `Engine.navigate()`
39
+
40
+ ### 2.2 Desde constitución Shards (v2.0.0)
41
+ - Shard DEBE heredar de Surface → Core
42
+ - Shard DEBE registrarse como WebComponent
43
+ - Shard DEBE implementar: `_mount()`, `_unmount()`, `update()`, `getTagName()`
44
+ - Estados: Loading, Mounted, Unmounted, Error
45
+ - Comunicación con Engine vía `notifyShardState()`
46
+
47
+ ### 2.3 Suposiciones
48
+ - La jerarquía correcta es: `Core` → `Surface` → `Page` / `Shard`
49
+ - Surface define hooks comunes (`onMount`, `onUnmount`)
50
+ - Demo debe ser funcional con E2E en 3 navegadores
51
+
52
+ ---
53
+
54
+ ## 3. Estado actual del código
55
+
56
+ ### 3.1 Core: `Surface` ([surface.mts](file:///Users/milos/Documents/workspace/extensio/packages/core/src/surface/surface.mts))
57
+
58
+ ```typescript
59
+ // Actual (57 líneas)
60
+ export abstract class Surface extends Core {
61
+ constructor(name: string, scope: string = 'surface') {
62
+ super(name, scope);
63
+ }
64
+
65
+ onMount(): void {
66
+ this.run(); // ⚠️ Incorrecto según constitución
67
+ }
68
+
69
+ onUnmount(): void { }
70
+
71
+ // Listener de Storage implementado ✅
72
+ protected override async listenProperty(key: string): Promise<void> { ... }
73
+ override _listen() { ... }
74
+ async onStorageChanged(...) { ... }
75
+ async checkListeners(...) { ... }
76
+ }
77
+ ```
78
+
79
+ **Gaps identificados:**
80
+ - `onMount()` llama a `run()`, pero según constitución debe ejecutarse DESPUÉS de `render()`
81
+ - Falta secuencia clara del ciclo de vida
82
+
83
+ ### 3.2 Core: `Page` ([pages/index.mts](file:///Users/milos/Documents/workspace/extensio/packages/core/src/surface/pages/index.mts))
84
+
85
+ ```typescript
86
+ // Actual (9 líneas) - MÍNIMA
87
+ export class Page extends Surface {
88
+ constructor(name: string, scope: string = Scope.Page) {
89
+ super(name, scope);
90
+ }
91
+ }
92
+ ```
93
+
94
+ **Gaps identificados:**
95
+ - ✅ Hereda de Surface (correcto)
96
+ - ⚠️ No implementa ningún método específico de Page
97
+ - ⚠️ No tiene método `render()` propio
98
+
99
+ ### 3.3 Core: `Shard` ([shards/index.mts](file:///Users/milos/Documents/workspace/extensio/packages/core/src/surface/shards/index.mts))
100
+
101
+ ```typescript
102
+ // Actual (249 líneas)
103
+ export abstract class Shard extends Core implements ShardLifecycle {
104
+ // ⚠️ HEREDA DE CORE, NO DE SURFACE ⚠️
105
+ ...
106
+ }
107
+ ```
108
+
109
+ **Gaps identificados:**
110
+ - 🔴 **CRÍTICO**: Hereda de `Core`, no de `Surface`
111
+ - La constitución exige: `Core` → `Surface` → `Shard`
112
+ - Tiene implementación robusta de:
113
+ - Registro WebComponent (`Shard.register()`) ✅
114
+ - Ciclo de vida (`mount`, `unmount`, `update`) ✅
115
+ - Comunicación con Engine (`notifyShardState`) ✅
116
+ - Estados (`Loading`, `Mounted`, `Unmounted`, `Error`) ✅
117
+ - **Problema**: Duplica lógica que debería estar en Surface
118
+
119
+ ### 3.4 Package.json exports
120
+
121
+ ```json
122
+ // Actual
123
+ "exports": {
124
+ "./shard": "./src/surface/shards/index.mts",
125
+ "./surface/pages": "./src/surface/pages/index.mts",
126
+ "./surface/shards": "./src/surface/shards/index.mts"
127
+ }
128
+ ```
129
+
130
+ **Gap**: Falta export explícito de `./surface` para la clase base Surface.
131
+
132
+ ---
133
+
134
+ ## 4. Estado actual del CLI
135
+
136
+ ### 4.1 Generadores existentes
137
+
138
+ | Generador | Estado |
139
+ |-----------|--------|
140
+ | `driver` | ✅ Funcional |
141
+ | `module` | ✅ Funcional (con opciones `withPage`, `withShard`) |
142
+ | `project` | ✅ Funcional |
143
+ | `page` | ❌ **NO EXISTE** |
144
+ | `shard` | ❌ **NO EXISTE** |
145
+
146
+ ### 4.2 Templates existentes (en generador module)
147
+
148
+ **Pages** (`templates/surface/pages/`):
149
+ - `index.mts.ejs` - índice de pages
150
+ - `home.mts.ejs` - página ejemplo
151
+ - `about.mts.ejs` - página ejemplo
152
+ - `styles.css.ejs` - estilos
153
+
154
+ **Shards** (`templates/surface/shards/`):
155
+ - `index.mts.ejs` - índice de shards
156
+ - `example.mts.ejs` - shard ejemplo
157
+ - `styles.css.ejs` - estilos
158
+
159
+ **Gaps en templates:**
160
+ - ⚠️ No siguen exactamente la estructura de constitución
161
+ - ⚠️ Falta template de HTML para Pages
162
+
163
+ ### 4.3 Plugins de build
164
+
165
+ | Plugin | Archivo | Estado |
166
+ |--------|---------|--------|
167
+ | `surface-pages` | [index.mts](file:///Users/milos/Documents/workspace/extensio/packages/cli/src/commands/plugins/surface-pages/index.mts) | ✅ Funcional |
168
+ | `process-shards` | [process-shards.mts](file:///Users/milos/Documents/workspace/extensio/packages/cli/src/commands/process-shards.mts) | ✅ Funcional |
169
+
170
+ Los plugins de build están implementados correctamente.
171
+
172
+ ---
173
+
174
+ ## 5. Demo actual
175
+
176
+ **Ubicación**: `packages/core/demo/`
177
+
178
+ **Contenido actual**:
179
+ ```
180
+ demo/
181
+ ├── node_modules/
182
+ ├── package.json
183
+ ├── src/
184
+ │ └── manifest.json # Solo esto
185
+ ├── tsconfig.json
186
+ └── tsconfig.tsbuildinfo
187
+ ```
188
+
189
+ **Gap crítico**: La demo está incompleta. Solo tiene un `manifest.json` sin:
190
+ - Engine
191
+ - Pages
192
+ - Shards
193
+ - Tests
194
+
195
+ ---
196
+
197
+ ## 6. Compatibilidad multi-browser
198
+
199
+ | Componente | Chrome | Firefox | Safari |
200
+ |------------|--------|---------|--------|
201
+ | Surface base | ✅ | ✅ | ✅ |
202
+ | Page (HTML) | ✅ | ✅ | ✅ |
203
+ | Shard (WebComponent) | ✅ | ✅ | ✅ |
204
+ | Storage reactivo | ✅ | ✅ | ✅ |
205
+ | `customElements.define` | ✅ | ✅ | ✅ |
206
+
207
+ No hay riesgos de compatibilidad identificados para los cambios propuestos.
208
+
209
+ ---
210
+
211
+ ## 7. Recomendaciones AI-first
212
+
213
+ ### 7.1 Orden de implementación recomendado
214
+
215
+ 1. **Refactorizar Surface** - Establecer ciclo de vida correcto
216
+ 2. **Hacer Shard heredar de Surface** - Cambio crítico
217
+ 3. **Completar Page** - Añadir métodos faltantes
218
+ 4. **Actualizar exports** - package.json
219
+ 5. **Crear generadores page/shard** - CLI independientes
220
+ 6. **Actualizar templates** - Conformidad con constitución
221
+ 7. **Reconstruir demo** - Usando CLI
222
+ 8. **Tests E2E** - 3 navegadores
223
+
224
+ ### 7.2 Estimación de esfuerzo
225
+
226
+ | Tarea | Complejidad | Estimación |
227
+ |-------|-------------|------------|
228
+ | Refactorizar Surface | Media | 1-2h |
229
+ | Migrar Shard → Surface | Alta | 2-3h |
230
+ | Completar Page | Baja | 30min |
231
+ | Generadores CLI | Media | 2h |
232
+ | Templates | Baja | 1h |
233
+ | Demo completa | Media | 2h |
234
+ | Tests E2E | Alta | 3-4h |
235
+
236
+ ---
237
+
238
+ ## 8. Riesgos y trade-offs
239
+
240
+ | Riesgo | Severidad | Mitigación |
241
+ |--------|-----------|------------|
242
+ | Breaking change en Shard | 🔴 Alta | Migración gradual, tests exhaustivos |
243
+ | Compatibilidad con módulos existentes | 🟡 Media | Validar demos existentes |
244
+ | Ciclo de vida de Surface | 🟡 Media | Documentar claramente la secuencia |
245
+
246
+ ---
247
+
248
+ ## 9. Fuentes
249
+
250
+ - [MDN: Custom Elements](https://developer.mozilla.org/en-US/docs/Web/API/Web_components/Using_custom_elements)
251
+ - [WebExtensions API](https://developer.mozilla.org/en-US/docs/Mozilla/Add-ons/WebExtensions)
252
+ - [Chrome Extensions Documentation](https://developer.chrome.com/docs/extensions/)
253
+ - Constitución Pages: `.agent/rules/constitution/pages.md` (v2.1.0)
254
+ - Constitución Shards: `.agent/rules/constitution/shards.md` (v2.0.0)
255
+
256
+ ---
257
+
258
+ ## 10. Aprobación del desarrollador (OBLIGATORIA)
259
+
260
+ ```yaml
261
+ approval:
262
+ developer:
263
+ decision: SI
264
+ date: 2026-01-14T07:26:50+01:00
265
+ comments: Aprobado para avanzar a Phase 2
266
+ ```