sinapse-ai 1.16.0 → 1.19.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (354) hide show
  1. package/.claude/hooks/doc-first-gate.cjs +156 -0
  2. package/.claude/hooks/enforce-story-gate.cjs +6 -2
  3. package/.claude/rules/documentation-first.md +6 -0
  4. package/.claude/rules/hook-governance.md +1 -0
  5. package/.sinapse-ai/constitution.md +3 -3
  6. package/.sinapse-ai/core/atlas/atlas-data.js +278 -0
  7. package/.sinapse-ai/core/atlas/flows-pt.js +253 -0
  8. package/.sinapse-ai/core/atlas/flows.js +266 -0
  9. package/.sinapse-ai/core/atlas/index.js +62 -0
  10. package/.sinapse-ai/core/atlas/render-html.js +216 -0
  11. package/.sinapse-ai/core/atlas/render-markdown.js +313 -0
  12. package/.sinapse-ai/core/atlas/render-research-card.js +164 -0
  13. package/.sinapse-ai/core/code-intel/registry-syncer.js +5 -3
  14. package/.sinapse-ai/core/doctor/checks/agent-memory.js +7 -5
  15. package/.sinapse-ai/core/doctor/checks/claude-md.js +13 -0
  16. package/.sinapse-ai/core/doctor/checks/constitution-consistency.js +1 -0
  17. package/.sinapse-ai/core/doctor/checks/hooks-claude-count.js +11 -0
  18. package/.sinapse-ai/core/doctor/checks/settings-json.js +16 -2
  19. package/.sinapse-ai/core/doctor/index.js +27 -0
  20. package/.sinapse-ai/core/execution/build-orchestrator.js +192 -8
  21. package/.sinapse-ai/core/external-executors/delegate-cli.js +6 -2
  22. package/.sinapse-ai/core/health-check/checks/project/constitution-consistency.js +2 -1
  23. package/.sinapse-ai/core/ideation/ideation-engine.js +10 -8
  24. package/.sinapse-ai/core/mcp/config-migrator.js +8 -5
  25. package/.sinapse-ai/core/mcp/global-config-manager.js +4 -1
  26. package/.sinapse-ai/core/mcp/symlink-manager.js +6 -3
  27. package/.sinapse-ai/core/orchestration/brownfield-handler.js +5 -4
  28. package/.sinapse-ai/core/orchestration/build-command.js +136 -0
  29. package/.sinapse-ai/core/orchestration/doc-first-resolver.js +322 -0
  30. package/.sinapse-ai/core/orchestration/executors/epic-4-executor.js +3 -0
  31. package/.sinapse-ai/core/orchestration/gate-evaluator.js +58 -9
  32. package/.sinapse-ai/core/orchestration/route-command.js +97 -0
  33. package/.sinapse-ai/core/orchestration/session-state.js +19 -2
  34. package/.sinapse-ai/core/orchestration/terminal-spawner.js +24 -1
  35. package/.sinapse-ai/core/orchestration/workflow-executor.js +102 -3
  36. package/.sinapse-ai/core/quality-gates/focus-area-recommender.js +15 -11
  37. package/.sinapse-ai/core/registry/build-registry.js +3 -2
  38. package/.sinapse-ai/core/synapse/scripts/generate-constitution.js +1 -0
  39. package/.sinapse-ai/core/synapse/utils/atomic-write.js +34 -9
  40. package/.sinapse-ai/core-config.yaml +5 -1
  41. package/.sinapse-ai/data/capability-detection.js +3 -3
  42. package/.sinapse-ai/data/entity-registry.yaml +288 -90
  43. package/.sinapse-ai/data/mcp-discipline.js +1 -1
  44. package/.sinapse-ai/data/mcp-tool-examples.yaml +8 -8
  45. package/.sinapse-ai/data/tok2-validation.js +1 -1
  46. package/.sinapse-ai/data/tool-registry.yaml +4 -3
  47. package/.sinapse-ai/development/agents/snps-orqx.md +14 -5
  48. package/.sinapse-ai/development/scripts/migrate-task-to-v2.js +1 -1
  49. package/.sinapse-ai/development/scripts/validate-task-v2.js +67 -4
  50. package/.sinapse-ai/development/tasks/advanced-elicitation.md +3 -3
  51. package/.sinapse-ai/development/tasks/analyst-facilitate-brainstorming.md +3 -3
  52. package/.sinapse-ai/development/tasks/analyze-framework.md +1 -8
  53. package/.sinapse-ai/development/tasks/analyze-performance.md +1 -8
  54. package/.sinapse-ai/development/tasks/apply-qa-fixes.md +3 -3
  55. package/.sinapse-ai/development/tasks/architect-analyze-impact.md +3 -3
  56. package/.sinapse-ai/development/tasks/audit-codebase.md +1 -8
  57. package/.sinapse-ai/development/tasks/audit-tailwind-config.md +1 -4
  58. package/.sinapse-ai/development/tasks/audit-utilities.md +1 -8
  59. package/.sinapse-ai/development/tasks/bootstrap-shadcn-library.md +3 -3
  60. package/.sinapse-ai/development/tasks/brownfield-create-epic.md +3 -3
  61. package/.sinapse-ai/development/tasks/brownfield-create-story.md +3 -3
  62. package/.sinapse-ai/development/tasks/build-component.md +2 -5
  63. package/.sinapse-ai/development/tasks/calculate-roi.md +3 -3
  64. package/.sinapse-ai/development/tasks/ci-cd-configuration.md +1 -1
  65. package/.sinapse-ai/development/tasks/cleanup-utilities.md +3 -3
  66. package/.sinapse-ai/development/tasks/collaborative-edit.md +3 -3
  67. package/.sinapse-ai/development/tasks/compose-molecule.md +2 -5
  68. package/.sinapse-ai/development/tasks/consolidate-patterns.md +3 -3
  69. package/.sinapse-ai/development/tasks/correct-course.md +3 -3
  70. package/.sinapse-ai/development/tasks/create-brownfield-story.md +2 -5
  71. package/.sinapse-ai/development/tasks/create-deep-research-prompt.md +2 -5
  72. package/.sinapse-ai/development/tasks/create-doc.md +3 -6
  73. package/.sinapse-ai/development/tasks/create-next-story.md +4 -8
  74. package/.sinapse-ai/development/tasks/create-suite.md +2 -5
  75. package/.sinapse-ai/development/tasks/create-task.md +2 -5
  76. package/.sinapse-ai/development/tasks/create-workflow.md +2 -5
  77. package/.sinapse-ai/development/tasks/db-analyze-hotpaths.md +1 -8
  78. package/.sinapse-ai/development/tasks/db-apply-migration.md +1 -8
  79. package/.sinapse-ai/development/tasks/db-bootstrap.md +1 -8
  80. package/.sinapse-ai/development/tasks/db-domain-modeling.md +1 -8
  81. package/.sinapse-ai/development/tasks/db-dry-run.md +1 -8
  82. package/.sinapse-ai/development/tasks/db-env-check.md +1 -8
  83. package/.sinapse-ai/development/tasks/db-explain.md +1 -8
  84. package/.sinapse-ai/development/tasks/db-impersonate.md +1 -8
  85. package/.sinapse-ai/development/tasks/db-load-csv.md +1 -8
  86. package/.sinapse-ai/development/tasks/db-policy-apply.md +1 -8
  87. package/.sinapse-ai/development/tasks/db-rls-audit.md +1 -8
  88. package/.sinapse-ai/development/tasks/db-rollback.md +1 -8
  89. package/.sinapse-ai/development/tasks/db-run-sql.md +1 -8
  90. package/.sinapse-ai/development/tasks/db-schema-audit.md +1 -8
  91. package/.sinapse-ai/development/tasks/db-seed.md +1 -8
  92. package/.sinapse-ai/development/tasks/db-smoke-test.md +1 -8
  93. package/.sinapse-ai/development/tasks/db-snapshot.md +1 -8
  94. package/.sinapse-ai/development/tasks/db-squad-integration.md +1 -8
  95. package/.sinapse-ai/development/tasks/db-supabase-setup.md +1 -8
  96. package/.sinapse-ai/development/tasks/db-verify-order.md +1 -8
  97. package/.sinapse-ai/development/tasks/deprecate-component.md +3 -3
  98. package/.sinapse-ai/development/tasks/dev-apply-qa-fixes.md +3 -3
  99. package/.sinapse-ai/development/tasks/dev-backlog-debt.md +3 -3
  100. package/.sinapse-ai/development/tasks/dev-develop-story.md +1 -1
  101. package/.sinapse-ai/development/tasks/dev-improve-code-quality.md +3 -3
  102. package/.sinapse-ai/development/tasks/dev-optimize-performance.md +3 -3
  103. package/.sinapse-ai/development/tasks/dev-suggest-refactoring.md +3 -3
  104. package/.sinapse-ai/development/tasks/dev-validate-next-story.md +3 -3
  105. package/.sinapse-ai/development/tasks/document-project.md +3 -3
  106. package/.sinapse-ai/development/tasks/environment-bootstrap.md +0 -4
  107. package/.sinapse-ai/development/tasks/execute-checklist.md +3 -3
  108. package/.sinapse-ai/development/tasks/export-design-tokens-dtcg.md +3 -3
  109. package/.sinapse-ai/development/tasks/extend-pattern.md +1 -8
  110. package/.sinapse-ai/development/tasks/extract-tokens.md +3 -3
  111. package/.sinapse-ai/development/tasks/facilitate-brainstorming-session.md +1 -1
  112. package/.sinapse-ai/development/tasks/generate-ai-frontend-prompt.md +2 -5
  113. package/.sinapse-ai/development/tasks/generate-documentation.md +2 -5
  114. package/.sinapse-ai/development/tasks/generate-migration-strategy.md +2 -5
  115. package/.sinapse-ai/development/tasks/generate-shock-report.md +2 -5
  116. package/.sinapse-ai/development/tasks/github-devops-github-pr-automation.md +3 -3
  117. package/.sinapse-ai/development/tasks/github-devops-repository-cleanup.md +3 -3
  118. package/.sinapse-ai/development/tasks/github-devops-version-management.md +3 -3
  119. package/.sinapse-ai/development/tasks/improve-self.md +1 -16
  120. package/.sinapse-ai/development/tasks/index-docs.md +1 -4
  121. package/.sinapse-ai/development/tasks/init-project-status.md +1 -7
  122. package/.sinapse-ai/development/tasks/integrate-squad.md +3 -3
  123. package/.sinapse-ai/development/tasks/kb-mode-interaction.md +3 -3
  124. package/.sinapse-ai/development/tasks/learn-patterns.md +3 -3
  125. package/.sinapse-ai/development/tasks/modify-agent.md +1 -8
  126. package/.sinapse-ai/development/tasks/modify-task.md +1 -8
  127. package/.sinapse-ai/development/tasks/modify-workflow.md +1 -8
  128. package/.sinapse-ai/development/tasks/po-backlog-add.md +3 -3
  129. package/.sinapse-ai/development/tasks/po-manage-story-backlog.md +3 -3
  130. package/.sinapse-ai/development/tasks/po-pull-story-from-clickup.md +3 -3
  131. package/.sinapse-ai/development/tasks/po-pull-story.md +3 -3
  132. package/.sinapse-ai/development/tasks/po-stories-index.md +3 -3
  133. package/.sinapse-ai/development/tasks/po-sync-story-to-clickup.md +3 -3
  134. package/.sinapse-ai/development/tasks/po-sync-story.md +3 -3
  135. package/.sinapse-ai/development/tasks/pr-automation.md +1 -1
  136. package/.sinapse-ai/development/tasks/propose-modification.md +3 -3
  137. package/.sinapse-ai/development/tasks/qa-backlog-add-followup.md +1 -8
  138. package/.sinapse-ai/development/tasks/qa-create-fix-request.md +1 -4
  139. package/.sinapse-ai/development/tasks/qa-gate.md +1 -8
  140. package/.sinapse-ai/development/tasks/qa-generate-tests.md +1 -8
  141. package/.sinapse-ai/development/tasks/qa-nfr-assess.md +1 -8
  142. package/.sinapse-ai/development/tasks/qa-review-proposal.md +1 -8
  143. package/.sinapse-ai/development/tasks/qa-review-story.md +1 -8
  144. package/.sinapse-ai/development/tasks/qa-risk-profile.md +1 -8
  145. package/.sinapse-ai/development/tasks/qa-run-tests.md +1 -8
  146. package/.sinapse-ai/development/tasks/qa-test-design.md +1 -8
  147. package/.sinapse-ai/development/tasks/qa-trace-requirements.md +1 -8
  148. package/.sinapse-ai/development/tasks/release-management.md +1 -1
  149. package/.sinapse-ai/development/tasks/security-audit.md +1 -4
  150. package/.sinapse-ai/development/tasks/security-scan.md +1 -4
  151. package/.sinapse-ai/development/tasks/setup-database.md +2 -11
  152. package/.sinapse-ai/development/tasks/setup-design-system.md +2 -11
  153. package/.sinapse-ai/development/tasks/shard-doc.md +3 -3
  154. package/.sinapse-ai/development/tasks/sm-create-next-story.md +3 -3
  155. package/.sinapse-ai/development/tasks/spec-gather-requirements.md +11 -0
  156. package/.sinapse-ai/development/tasks/sync-documentation.md +1 -6
  157. package/.sinapse-ai/development/tasks/tailwind-upgrade.md +3 -3
  158. package/.sinapse-ai/development/tasks/test-as-user.md +3 -3
  159. package/.sinapse-ai/development/tasks/undo-last.md +2 -5
  160. package/.sinapse-ai/development/tasks/update-manifest.md +1 -8
  161. package/.sinapse-ai/development/tasks/ux-create-wireframe.md +1 -1
  162. package/.sinapse-ai/development/tasks/ux-ds-scan-artifact.md +3 -3
  163. package/.sinapse-ai/development/tasks/ux-user-research.md +3 -3
  164. package/.sinapse-ai/development/tasks/validate-next-story.md +1 -8
  165. package/.sinapse-ai/development/templates/approval-table.md +106 -0
  166. package/.sinapse-ai/development/templates/chrome-brain/scripts/chrome-ensure.cjs +1 -1
  167. package/.sinapse-ai/development/workflows/spec-pipeline.yaml +1 -0
  168. package/.sinapse-ai/git-hooks/post-commit +0 -0
  169. package/.sinapse-ai/git-hooks/pre-commit +0 -0
  170. package/.sinapse-ai/git-hooks/pre-push +0 -0
  171. package/.sinapse-ai/infrastructure/scripts/changelog-generator.js +5 -1
  172. package/.sinapse-ai/infrastructure/scripts/pattern-extractor.js +11 -2
  173. package/.sinapse-ai/infrastructure/scripts/test-utilities.js +34 -13
  174. package/.sinapse-ai/infrastructure/scripts/usage-analytics.js +9 -5
  175. package/.sinapse-ai/infrastructure/scripts/validate-claude-integration.js +10 -2
  176. package/.sinapse-ai/install-manifest.yaml +364 -320
  177. package/.sinapse-ai/lib/build.json +1 -0
  178. package/.sinapse-ai/product/templates/personalized-task-template-v2.md +4 -2
  179. package/.sinapse-ai/product/templates/prd-tmpl.yaml +6 -2
  180. package/.sinapse-ai/product/templates/statusline/statusline-script.js +7 -3
  181. package/CHANGELOG.md +85 -7
  182. package/README.en.md +5 -5
  183. package/README.md +5 -5
  184. package/bin/cli.js +1 -1
  185. package/bin/commands/install.js +288 -114
  186. package/bin/commands/local.js +11 -0
  187. package/bin/lib/command-generator.js +31 -2
  188. package/bin/sinapse.js +121 -0
  189. package/docs/README.md +1 -1
  190. package/docs/agent-reference-guide.md +1 -1
  191. package/docs/community/README-community-snippet-core.md +1 -1
  192. package/docs/community/README-community-snippet-mcp.md +1 -1
  193. package/docs/community/README-community-snippet-squads.md +1 -1
  194. package/docs/examples/quickstart-recording.md +1 -1
  195. package/docs/framework/README.md +1 -1
  196. package/docs/framework/architecture-overview.md +1 -0
  197. package/docs/framework/atlas/OPERATING-ATLAS.md +537 -0
  198. package/docs/framework/atlas/README.md +34 -0
  199. package/docs/framework/atlas/atlas-data.json +2810 -0
  200. package/docs/framework/atlas/atlas.html +392 -0
  201. package/docs/framework/coding-standards.md +1 -1
  202. package/docs/framework/core-architecture.md +1 -1
  203. package/docs/framework/guiding-principles.md +1 -1
  204. package/docs/framework/source-tree.md +1 -1
  205. package/docs/framework/tech-stack.md +1 -1
  206. package/docs/framework/versioning-and-releases.md +1 -1
  207. package/docs/getting-started.md +1 -1
  208. package/docs/guides/agent-reference.md +1 -1
  209. package/docs/guides/agent-selection-guide.md +1 -1
  210. package/docs/guides/api-reference.md +1 -1
  211. package/docs/guides/contextual-greeting-system-guide.md +1 -1
  212. package/docs/guides/contributing-squads.md +1 -1
  213. package/docs/guides/development-setup.md +1 -1
  214. package/docs/guides/git-workflow-guide.md +1 -1
  215. package/docs/guides/installation-troubleshooting.md +1 -1
  216. package/docs/guides/llm-routing.md +1 -1
  217. package/docs/guides/mcp-global-setup.md +1 -1
  218. package/docs/guides/meta-agent-commands.md +1 -1
  219. package/docs/guides/project-status-feature.md +1 -1
  220. package/docs/guides/quality-dashboard.md +1 -1
  221. package/docs/guides/quality-gates.md +1 -1
  222. package/docs/guides/security-hardening.md +1 -1
  223. package/docs/guides/service-discovery.md +19 -22
  224. package/docs/guides/squad-examples/README.md +1 -1
  225. package/docs/guides/squad-migration.md +1 -1
  226. package/docs/guides/squads-guide.md +1 -1
  227. package/docs/guides/squads-overview.md +10 -13
  228. package/docs/guides/template-engine-v2.md +1 -1
  229. package/docs/guides/testing-guide.md +1 -1
  230. package/docs/guides/user-guide.md +30 -26
  231. package/docs/installation/README.md +3 -3
  232. package/docs/installation/faq.md +1 -1
  233. package/docs/installation/linux.md +2 -2
  234. package/docs/installation/macos.md +1 -1
  235. package/docs/installation/npx-install.md +1 -1
  236. package/docs/installation/troubleshooting.md +1 -1
  237. package/docs/installation/uninstallation.md +1 -1
  238. package/docs/installation/v4-quick-start.md +1 -1
  239. package/docs/installation/windows.md +2 -2
  240. package/docs/pt/CHANGELOG.md +1 -1
  241. package/docs/pt/DOCUMENTATION-ROADMAP.md +1 -1
  242. package/docs/pt/ENVIRONMENT.md +1 -1
  243. package/docs/pt/FEATURE_PROCESS.md +2 -2
  244. package/docs/pt/GUIDING-PRINCIPLES.md +2 -2
  245. package/docs/pt/agent-reference-guide.md +3 -3
  246. package/docs/pt/architecture/ARCHITECTURE-INDEX.md +2 -2
  247. package/docs/pt/architecture/ade-architecture.md +1 -1
  248. package/docs/pt/architecture/agent-config-audit.md +1 -1
  249. package/docs/pt/architecture/agent-responsibility-matrix.md +1 -1
  250. package/docs/pt/architecture/agent-tool-integration-guide.md +1 -1
  251. package/docs/pt/architecture/ci-cd.md +1 -1
  252. package/docs/pt/architecture/coding-standards.md +1 -1
  253. package/docs/pt/architecture/contribution-workflow-research.md +1 -1
  254. package/docs/pt/architecture/dashboard-architecture.md +1 -1
  255. package/docs/pt/architecture/dashboard-realtime.md +1 -1
  256. package/docs/pt/architecture/hcs-check-specifications.md +1 -1
  257. package/docs/pt/architecture/hcs-execution-modes.md +1 -1
  258. package/docs/pt/architecture/hcs-self-healing-spec.md +1 -1
  259. package/docs/pt/architecture/high-level-architecture.md +1 -1
  260. package/docs/pt/architecture/introduction.md +1 -1
  261. package/docs/pt/architecture/mcp-api-keys-management.md +3 -3
  262. package/docs/pt/architecture/mcp-system-diagrams.md +1 -1
  263. package/docs/pt/architecture/module-system.md +4 -4
  264. package/docs/pt/architecture/multi-repo-strategy.md +2 -2
  265. package/docs/pt/architecture/source-tree.md +1 -1
  266. package/docs/pt/architecture/squad-improvement-analysis.md +1 -1
  267. package/docs/pt/architecture/squad-improvement-recommended-approach.md +1 -1
  268. package/docs/pt/architecture/tech-stack.md +1 -1
  269. package/docs/pt/architecture/utility-integration-guide.md +1 -1
  270. package/docs/pt/code-of-conduct.md +1 -1
  271. package/docs/pt/community/README-community-snippet-core.md +1 -1
  272. package/docs/pt/community/README-community-snippet-mcp.md +2 -2
  273. package/docs/pt/contributing.md +7 -7
  274. package/docs/pt/core-architecture.md +1 -1
  275. package/docs/pt/docker-mcp-setup.md +1 -1
  276. package/docs/pt/framework/README.md +1 -1
  277. package/docs/pt/framework/coding-standards.md +1 -1
  278. package/docs/pt/framework/source-tree.md +1 -1
  279. package/docs/pt/framework/tech-stack.md +1 -1
  280. package/docs/pt/getting-started.md +1 -1
  281. package/docs/pt/git-workflow-guide.md +1 -1
  282. package/docs/pt/guides/README.md +3 -3
  283. package/docs/pt/guides/agent-selection-guide.md +2 -2
  284. package/docs/pt/guides/api-reference.md +1 -1
  285. package/docs/pt/guides/contextual-greeting-system-guide.md +1 -1
  286. package/docs/pt/guides/contributing-squads.md +1 -1
  287. package/docs/pt/guides/development-setup.md +1 -1
  288. package/docs/pt/guides/installation-troubleshooting.md +1 -1
  289. package/docs/pt/guides/llm-routing.md +1 -1
  290. package/docs/pt/guides/mcp/desktop-commander.md +1 -1
  291. package/docs/pt/guides/mcp/docker-gateway-tutorial.md +1 -1
  292. package/docs/pt/guides/mcp-global-setup.md +1 -1
  293. package/docs/pt/guides/project-status-feature.md +1 -1
  294. package/docs/pt/guides/quality-dashboard.md +1 -1
  295. package/docs/pt/guides/quality-gates.md +1 -1
  296. package/docs/pt/guides/security-hardening.md +2 -2
  297. package/docs/pt/guides/service-discovery.md +19 -22
  298. package/docs/pt/guides/squad-examples/README.md +1 -1
  299. package/docs/pt/guides/squad-migration.md +1 -1
  300. package/docs/pt/guides/squads-guide.md +1 -1
  301. package/docs/pt/guides/squads-overview.md +11 -13
  302. package/docs/pt/guides/template-engine-v2.md +1 -1
  303. package/docs/pt/guides/testing-guide.md +3 -3
  304. package/docs/pt/guides/user-guide.md +30 -26
  305. package/docs/pt/guides/workflows-guide.md +1 -1
  306. package/docs/pt/how-to-contribute-with-pull-requests.md +1 -1
  307. package/docs/pt/ide-integration.md +2 -2
  308. package/docs/pt/installation/README.md +1 -1
  309. package/docs/pt/installation/faq.md +1 -1
  310. package/docs/pt/installation/linux.md +1 -1
  311. package/docs/pt/installation/macos.md +1 -1
  312. package/docs/pt/installation/troubleshooting.md +1 -1
  313. package/docs/pt/installation/v4-quick-start.md +1 -1
  314. package/docs/pt/installation/windows.md +1 -1
  315. package/docs/pt/meta-agent-commands.md +1 -1
  316. package/docs/pt/migration-guide.md +1 -1
  317. package/docs/pt/npx-install.md +1 -1
  318. package/docs/pt/performance-tuning-guide.md +1 -1
  319. package/docs/pt/platforms/claude-code.md +2 -2
  320. package/docs/pt/roadmap.md +2 -2
  321. package/docs/pt/security-best-practices.md +2 -2
  322. package/docs/pt/security.md +1 -1
  323. package/docs/pt/sinapse-nomenclature-specification.md +1 -1
  324. package/docs/pt/troubleshooting.md +1 -1
  325. package/docs/pt/uninstallation.md +1 -1
  326. package/docs/pt/versioning-and-releases.md +1 -1
  327. package/docs/security/overview.md +1 -1
  328. package/docs/security/security-best-practices.md +2 -2
  329. package/docs/sinapse-workflows/README.md +1 -1
  330. package/package.json +2 -1
  331. package/packages/installer/package.json +1 -0
  332. package/packages/installer/src/wizard/feedback.js +18 -2
  333. package/packages/installer/src/wizard/i18n.js +78 -0
  334. package/packages/installer/src/wizard/ide-config-generator.js +14 -9
  335. package/packages/installer/src/wizard/index.js +16 -16
  336. package/packages/installer/src/wizard/validation/report-generator.js +22 -21
  337. package/packages/installer/src/wizard/validation/troubleshooting-system.js +19 -13
  338. package/scripts/gen-agent-badges.js +1 -1
  339. package/scripts/install-chrome-brain.sh +2 -2
  340. package/scripts/package-synapse.js +14 -5
  341. package/scripts/prepare-hooks.js +19 -0
  342. package/scripts/validate-agent-codenames.js +174 -0
  343. package/scripts/validate-all.js +1 -0
  344. package/scripts/validate-no-personal-leaks.js +24 -9
  345. package/sinapse/agents/sinapse-orqx.md +5 -5
  346. package/sinapse/agents/snps-orqx.md +5 -5
  347. package/squads/squad-brand/agents/brand-creative-engineer.md +5 -5
  348. package/squads/squad-brand/squad.yaml +6 -6
  349. package/squads/squad-content/agents/content-engineer.md +7 -7
  350. package/squads/squad-content/squad.yaml +5 -5
  351. package/squads/squad-copy/knowledge-base/consequence-headline-patterns.md +2 -2
  352. package/squads/squad-courses/agents/production-director.md +5 -5
  353. package/squads/squad-courses/squad.yaml +1 -1
  354. package/docs/guides/hooks-two-layers.md +0 -66
@@ -6,7 +6,7 @@
6
6
 
7
7
  # Guia de Service Discovery SINAPSE
8
8
 
9
- > 🌐 [EN](../../guides/service-discovery.md) | **PT** | [ES](../../es/guides/service-discovery.md)
9
+ > 🌐 [EN](../../guides/service-discovery.md) | **PT**
10
10
 
11
11
  ---
12
12
 
@@ -137,25 +137,25 @@ const count = await registry.count();
137
137
 
138
138
  ## Comandos CLI
139
139
 
140
- ### `sinapse discover`
140
+ ### `sinapse workers search`
141
141
 
142
142
  Pesquisar workers no registry.
143
143
 
144
144
  ```bash
145
145
  # Pesquisar por texto
146
- sinapse discover "create story"
146
+ sinapse workers search "create story"
147
147
 
148
- # Pesquisar por categoria
149
- sinapse discover --category task
148
+ # Filtrar por categoria
149
+ sinapse workers search "story" --category=task
150
150
 
151
- # Pesquisar por tag
152
- sinapse discover --tag testing
151
+ # Filtrar por tags (separadas por vírgula)
152
+ sinapse workers search "validation" --tags=schema,json
153
153
 
154
- # Pesquisar para agente
155
- sinapse discover --agent dev
154
+ # Limitar resultados
155
+ sinapse workers search "story" --limit=5
156
156
 
157
- # Combinar filtros
158
- sinapse discover --category task --tag development --agent dev
157
+ # Saída em JSON
158
+ sinapse workers search "api" --format=json
159
159
  ```
160
160
 
161
161
  **Saída:**
@@ -221,22 +221,19 @@ Performance:
221
221
  Paralelizável: Não
222
222
  ```
223
223
 
224
- ### `sinapse list`
224
+ ### Listar workers por categoria
225
225
 
226
- Listar workers por categoria ou agente.
226
+ Use `sinapse workers search` com o filtro `--category` para restringir os resultados a um tipo de worker.
227
227
 
228
228
  ```bash
229
- # Listar todas as tasks
230
- sinapse list tasks
229
+ # Encontrar tasks
230
+ sinapse workers search "story" --category=task
231
231
 
232
- # Listar todos os templates
233
- sinapse list templates
232
+ # Encontrar templates
233
+ sinapse workers search "template" --category=template
234
234
 
235
- # Listar workers para agente
236
- sinapse list --agent dev
237
-
238
- # Listar com paginação
239
- sinapse list tasks --page 1 --limit 20
235
+ # Limitar o número de resultados
236
+ sinapse workers search "story" --category=task --limit=20
240
237
  ```
241
238
 
242
239
  ---
@@ -46,7 +46,7 @@ Cada exemplo inclui comentarios explicando:
46
46
 
47
47
  ## Criando o Seu Proprio
48
48
 
49
- 1. Comece com o [Template de Squad](../../../../templates/squad/)
49
+ 1. Comece com o [Template de Squad](../../../../.sinapse-ai/development/templates/squad-template/)
50
50
  2. Use estes exemplos como referencia para padroes
51
51
  3. Siga o [Guia de Squads](../squads-guide.md)
52
52
 
@@ -6,7 +6,7 @@
6
6
 
7
7
  # Guia de Migração de Squad
8
8
 
9
- > 🌐 [EN](../../guides/squad-migration.md) | **PT** | [ES](../../es/guides/squad-migration.md)
9
+ > 🌐 [EN](../../guides/squad-migration.md) | **PT**
10
10
 
11
11
  ---
12
12
 
@@ -6,7 +6,7 @@
6
6
 
7
7
  # Guia de Desenvolvimento de Squads
8
8
 
9
- > 🌐 [EN](../../guides/squads-guide.md) | **PT** | [ES](../../es/guides/squads-guide.md)
9
+ > 🌐 [EN](../../guides/squads-guide.md) | **PT**
10
10
 
11
11
  ---
12
12
 
@@ -189,19 +189,17 @@ tags:
189
189
 
190
190
  ### Instalando Squads
191
191
 
192
- ```bash
193
- # Listar squads disponíveis
194
- sinapse squads list
195
-
196
- # Baixar do repositório oficial
197
- *download-squad etl-squad
192
+ Os squads vivem no diretório `squads/` do projeto. Cada squad é uma pasta
193
+ autocontida com seus próprios agentes, tasks e configuração, e é reconhecido
194
+ automaticamente pelo framework — não há etapa de instalação.
198
195
 
199
- # Baixar versão específica
200
- *download-squad etl-squad@2.0.0
196
+ - **Adicionar um squad** — coloque a pasta dele em `squads/`.
197
+ - **Criar um squad** — use o agente `squad-creator` para gerar um novo.
201
198
 
202
- # Listar squads locais
203
- *list-squads
204
- ```
199
+ > **Roadmap:** a distribuição remota de squads — navegar, baixar e publicar
200
+ > squads por um registro compartilhado (Níveis 2–3 acima) — está planejada, mas
201
+ > ainda não disponível. Por enquanto, os squads são gerenciados localmente em
202
+ > `squads/`.
205
203
 
206
204
  ---
207
205
 
@@ -265,11 +263,11 @@ Use versionamento semântico:
265
263
  | `*create-squad {name} --from-design` | Criar a partir de blueprint de design |
266
264
  | `*validate-squad {name}` | Validar estrutura do squad |
267
265
  | `*list-squads` | Listar todos os squads locais |
268
- | `*download-squad {name}` | Baixar do repositório |
266
+ | `*download-squad {name}` | Baixar do repositório (roadmap) |
269
267
  | `*design-squad` | Projetar squad a partir de documentação |
270
268
  | `*analyze-squad {name}` | Analisar estrutura do squad |
271
269
  | `*extend-squad {name}` | Adicionar componentes ao squad |
272
- | `*publish-squad {path}` | Publicar no repositório |
270
+ | `*publish-squad {path}` | Publicar no repositório (roadmap) |
273
271
 
274
272
  ---
275
273
 
@@ -6,7 +6,7 @@
6
6
 
7
7
  # Template Engine v2.0
8
8
 
9
- > 🌐 [EN](../../guides/template-engine-v2.md) | **PT** | [ES](../../es/guides/template-engine-v2.md)
9
+ > 🌐 [EN](../../guides/template-engine-v2.md) | **PT**
10
10
 
11
11
  ---
12
12
 
@@ -1,6 +1,6 @@
1
1
  # Guia de Testes do SINAPSE
2
2
 
3
- > [EN](../../guides/testing-guide.md) | **PT** | [ES](../../es/guides/testing-guide.md)
3
+ > [EN](../../guides/testing-guide.md) | **PT**
4
4
 
5
5
  ---
6
6
 
@@ -1207,8 +1207,8 @@ module.exports = {
1207
1207
  ## Documentação Relacionada
1208
1208
 
1209
1209
  - [Guia de Quality Gates](./quality-gates.md) - Verificações automatizadas de qualidade
1210
- - [Arquitetura CI/CD](../../architecture/ci-cd.md) - Configuração de pipeline
1211
- - [Guia de Contribuição](../../how-to-contribute-with-pull-requests.md) - Fluxo de desenvolvimento
1210
+ - [Arquitetura CI/CD](../architecture/ci-cd.md) - Configuração de pipeline
1211
+ - [Guia de Contribuição](../how-to-contribute-with-pull-requests.md) - Fluxo de desenvolvimento
1212
1212
 
1213
1213
  ---
1214
1214
 
@@ -164,22 +164,29 @@ Workflows orquestram múltiplas tasks e agentes para operações complexas.
164
164
 
165
165
  ### Workflows Disponíveis
166
166
 
167
- | Workflow | Caso de Uso | Agentes Envolvidos |
168
- | ------------------------ | -------------------------- | ------------------ |
169
- | `greenfield-fullstack` | Novo projeto full-stack | Todos os agentes |
170
- | `brownfield-integration` | Adicionar SINAPSE a existente | dev, architect |
171
- | `fork-join` | Execução paralela de tasks | Múltiplos |
172
- | `organizer-worker` | Execução delegada | po, dev |
173
- | `data-pipeline` | Workflows de ETL | data-engineer, qa |
167
+ | Workflow | Caso de Uso |
168
+ | ------------------------- | ------------------------------------- |
169
+ | `greenfield-ui` | Novo site / landing page / app |
170
+ | `greenfield-fullstack` | Nova plataforma / SaaS |
171
+ | `greenfield-service` | Nova API / serviço de backend |
172
+ | `brownfield-fullstack` | Adicionar SINAPSE a projeto existente |
173
+ | `spec-pipeline` | Briefing complexo (spec primeiro) |
174
+ | `story-development-cycle` | Implementar uma única story |
174
175
 
175
176
  ### Executando Workflows
176
177
 
178
+ Você não chama os workflows pelo nome — descreva o que quer e o SINAPSE escolhe
179
+ o certo (greenfield vs brownfield, UI vs fullstack vs service).
180
+
177
181
  ```bash
178
- # Iniciar um workflow
179
- sinapse workflow greenfield-fullstack
182
+ # Descreva o projeto — o SINAPSE classifica e roda o workflow certo
183
+ sinapse build "nova plataforma SaaS para gestão de academia"
184
+
185
+ # Veja qual workflow um briefing dispararia (sem executar)
186
+ sinapse route "adicionar dark mode na plataforma"
180
187
 
181
- # Com parâmetros
182
- sinapse workflow brownfield-integration --target=./existing-project
188
+ # Rodar o ciclo de desenvolvimento de uma story existente
189
+ sinapse orchestrate <story-id>
183
190
  ```
184
191
 
185
192
  ---
@@ -204,25 +211,25 @@ Um squad é um pacote autocontido contendo:
204
211
  ### Níveis de Distribuição
205
212
 
206
213
  ```
207
- Nível 1: LOCAL --> ./squads/ (Privado)
208
- Nível 2: SINAPSE-SQUADS --> github.com/SinapseAI (Público/Gratuito)
209
- Nível 3: SINAPSE API --> api.sinapse.ai (Marketplace)
214
+ Nível 1: LOCAL --> ./squads/ (hoje — gerenciado no seu projeto)
215
+ Nível 2: REGISTRY --> compartilhamento (roadmap)
216
+ Nível 3: MARKETPLACE --> squads pagos (roadmap)
210
217
  ```
211
218
 
212
219
  ### Usando Squads
213
220
 
214
- ```bash
215
- # Listar squads disponíveis
216
- sinapse squads list
217
-
218
- # Baixar um squad
219
- sinapse squads download etl-squad
221
+ Os squads ficam no diretório `squads/` do seu projeto. Para adicionar um, coloque
222
+ a pasta dele ali; para construir um novo, gere-o com o agente squad-creator:
220
223
 
224
+ ```bash
221
225
  # Criar seu próprio squad
222
226
  @squad-creator
223
227
  *create-squad my-custom-squad
224
228
  ```
225
229
 
230
+ > A distribuição remota de squads (navegar / baixar de um registro) está no
231
+ > roadmap — hoje os squads são gerenciados diretamente em `squads/`.
232
+
226
233
  ### Squads Oficiais
227
234
 
228
235
  | Squad | Descrição |
@@ -384,7 +391,7 @@ sinapse rebuild
384
391
  ### Tópicos Avançados
385
392
 
386
393
  - [Guia de Quality Gates](./quality-gates.md)
387
- - [Estratégia Multi-Repo](../../architecture/multi-repo-strategy.md)
394
+ - [Estratégia Multi-Repo](../architecture/multi-repo-strategy.md)
388
395
  - [Integração MCP](./mcp-global-setup.md)
389
396
  - [Integração com IDE](../../ide-integration.md)
390
397
 
@@ -430,11 +437,8 @@ Mantenha o contexto entre sessões:
430
437
 
431
438
  ### 5. Aproveite os Squads
432
439
 
433
- Não reinvente a roda - verifique se existem squads:
434
-
435
- ```bash
436
- sinapse squads search {keyword}
437
- ```
440
+ Não reinvente a roda explore os squads que já vêm em `squads/` antes de
441
+ construir um agente novo do zero.
438
442
 
439
443
  ---
440
444
 
@@ -391,7 +391,7 @@ cat .sinapse-ai/development/workflows/{name}.yaml
391
391
 
392
392
  ## Documentacao Relacionada
393
393
 
394
- - [Diagrama de Workflow HybridOps](./hybridOps/workflow-diagram.md) - Padroes de colaboracao humano-agent
394
+ - Diagrama de Workflow HybridOps - Padroes de colaboracao humano-agent
395
395
  - [Guia de Referencia de Agents](../agent-reference-guide.md) - Agents disponiveis e suas capacidades
396
396
  - [Desenvolvimento Orientado a Story](./user-guide.md#story-driven-development) - O workflow de story
397
397
 
@@ -2,7 +2,7 @@
2
2
 
3
3
  # Como Contribuir com Pull Requests
4
4
 
5
- > 🌐 [EN](../how-to-contribute-with-pull-requests.md) | **PT** | [ES](../es/how-to-contribute-with-pull-requests.md)
5
+ > 🌐 **PT**
6
6
 
7
7
  ---
8
8
 
@@ -384,9 +384,9 @@ npm run sync:ide:cursor
384
384
 
385
385
  ## Documentação Relacionada
386
386
 
387
- - [Guias de Plataforma](./platforms/README.md)
387
+ - Guias de Plataforma
388
388
  - [Guia do Claude Code](./platforms/claude-code.md)
389
- - [Guia do Cursor](./platforms/cursor.md)
389
+ - Guia do Cursor
390
390
  - [Guia de Referência de Agentes](./agent-reference-guide.md)
391
391
  - [Configuração Global do MCP](./guides/mcp-global-setup.md)
392
392
 
@@ -6,7 +6,7 @@
6
6
 
7
7
  # Documentação de Instalação do SINAPSE
8
8
 
9
- > 🌐 [EN](../../installation/README.md) | **PT** | [ES](../../es/installation/README.md)
9
+ > 🌐 [EN](../../installation/README.md) | **PT**
10
10
 
11
11
  ---
12
12
 
@@ -6,7 +6,7 @@
6
6
 
7
7
  # FAQ do SINAPSE
8
8
 
9
- > 🌐 [EN](../../installation/faq.md) | **PT** | [ES](../../es/installation/faq.md)
9
+ > 🌐 [EN](../../installation/faq.md) | **PT**
10
10
 
11
11
  ---
12
12
 
@@ -6,7 +6,7 @@
6
6
 
7
7
  # Guia de Instalação Linux para SINAPSE
8
8
 
9
- > 🌐 [EN](../../installation/linux.md) | **PT** | [ES](../../es/installation/linux.md)
9
+ > 🌐 [EN](../../installation/linux.md) | **PT**
10
10
 
11
11
  ---
12
12
 
@@ -6,7 +6,7 @@
6
6
 
7
7
  # Guia de Instalação para macOS - SINAPSE
8
8
 
9
- > 🌐 [EN](../../installation/macos.md) | **PT** | [ES](../../es/installation/macos.md)
9
+ > 🌐 [EN](../../installation/macos.md) | **PT**
10
10
 
11
11
  ---
12
12
 
@@ -6,7 +6,7 @@
6
6
 
7
7
  # Guia de Solução de Problemas do SINAPSE
8
8
 
9
- > 🌐 [EN](../../installation/troubleshooting.md) | **PT** | [ES](../../es/installation/troubleshooting.md)
9
+ > 🌐 [EN](../../installation/troubleshooting.md) | **PT**
10
10
 
11
11
  ---
12
12
 
@@ -1,6 +1,6 @@
1
1
  # Guia de Início Rápido SINAPSE v4
2
2
 
3
- > 🌐 [EN](../../installation/v4-quick-start.md) | **PT** | [ES](../../es/installation/v4-quick-start.md)
3
+ > 🌐 [EN](../../installation/v4-quick-start.md) | **PT**
4
4
 
5
5
  ---
6
6
 
@@ -6,7 +6,7 @@
6
6
 
7
7
  # Guia de Instalação Windows para SINAPSE
8
8
 
9
- > 🌐 [EN](../../installation/windows.md) | **PT** | [ES](../../es/installation/windows.md)
9
+ > 🌐 [EN](../../installation/windows.md) | **PT**
10
10
 
11
11
  ---
12
12
 
@@ -6,7 +6,7 @@
6
6
 
7
7
  # Referência de Comandos do Meta-Agente
8
8
 
9
- > 🌐 [EN](../meta-agent-commands.md) | **PT** | [ES](../es/meta-agent-commands.md)
9
+ > 🌐 [EN](../guides/meta-agent-commands.md) | **PT**
10
10
 
11
11
  ---
12
12
 
@@ -6,7 +6,7 @@
6
6
 
7
7
  # Guia de Atualização do SINAPSE
8
8
 
9
- > 🌐 [EN](../migration-guide.md) | **PT** | [ES](../es/migration-guide.md)
9
+ > 🌐 **PT**
10
10
 
11
11
  ---
12
12
 
@@ -6,7 +6,7 @@
6
6
 
7
7
  # Guia de Instalação via NPX
8
8
 
9
- > 🌐 [EN](../npx-install.md) | **PT** | [ES](../es/npx-install.md)
9
+ > 🌐 [EN](../installation/npx-install.md) | **PT**
10
10
 
11
11
  ---
12
12
 
@@ -6,7 +6,7 @@
6
6
 
7
7
  # Guia de Otimização de Performance do SINAPSE
8
8
 
9
- > 🌐 [EN](../performance-tuning-guide.md) | **PT** | [ES](../es/performance-tuning-guide.md)
9
+ > 🌐 **PT**
10
10
 
11
11
  ---
12
12
 
@@ -1,6 +1,6 @@
1
1
  # Guia SINAPSE para Claude Code
2
2
 
3
- > 🌐 [EN](../../platforms/claude-code.md) | **PT** | [ES](../../es/platforms/claude-code.md)
3
+ > 🌐 **PT**
4
4
 
5
5
  ---
6
6
 
@@ -92,7 +92,7 @@ winget install Anthropic.ClaudeCode
92
92
  claude login
93
93
 
94
94
  # Ou definir a chave API diretamente
95
- export ANTHROPIC_API_KEY="sua-chave-api"
95
+ export ANTHROPIC_API_KEY="<sua-chave-api>"
96
96
  ```
97
97
 
98
98
  ### Passo 3: Instalar o SINAPSE
@@ -71,11 +71,11 @@ Tem uma nova ideia? Abra uma [Discussão de Ideia](https://github.com/caioimori/
71
71
 
72
72
  ### 3. Escreva um RFC
73
73
 
74
- Para features significativas que precisam de design detalhado, [submeta um RFC](/.github/RFC_TEMPLATE.md) seguindo nosso processo estruturado.
74
+ Para features significativas que precisam de design detalhado, [submeta um RFC](../../.github/RFC_TEMPLATE.md) seguindo nosso processo estruturado.
75
75
 
76
76
  ### 4. Contribua Diretamente
77
77
 
78
- Encontrou algo que quer implementar? Veja nosso [Guia de Contribuição](CONTRIBUTING-PT.md) e [Processo de Features](docs/feature-process.md).
78
+ Encontrou algo que quer implementar? Veja nosso Guia de Contribuição e [Processo de Features](../framework/feature-process.md).
79
79
 
80
80
  ## Changelog
81
81
 
@@ -6,7 +6,7 @@
6
6
 
7
7
  # Melhores Práticas de Segurança do SINAPSE
8
8
 
9
- > 🌐 [EN](../security-best-practices.md) | **PT** | [ES](../es/security-best-practices.md)
9
+ > 🌐 [EN](../security/security-best-practices.md) | **PT**
10
10
 
11
11
  ---
12
12
 
@@ -66,7 +66,7 @@ const auth = new AuthSystem({
66
66
  // Criar usuário com requisitos de senha forte
67
67
  await auth.createUser({
68
68
  username: 'admin',
69
- password: 'SecureP@ssw0rd123!',
69
+ password: process.env.ADMIN_PASSWORD, // nunca faca hardcode — 12+ chars, maiusc/minusc, numero, simbolo
70
70
  email: 'admin@example.com',
71
71
  role: 'admin'
72
72
  });
@@ -148,7 +148,7 @@ Apenas `@devops` (Pipeline) pode executar `git push`. O hook `enforce-git-push-a
148
148
 
149
149
  ## Arquitetura de Hooks
150
150
 
151
- O SINAPSE-AI usa 19 hooks Claude Code organizados por evento de trigger:
151
+ O SINAPSE-AI usa 17 hooks Claude Code organizados por evento de trigger:
152
152
 
153
153
  ### Mapa de Eventos dos Hooks
154
154
 
@@ -6,7 +6,7 @@
6
6
 
7
7
  # Especificação de Nomenclatura do SINAPSE
8
8
 
9
- > 🌐 [EN](../sinapse-nomenclature-specification.md) | **PT** | [ES](../es/sinapse-nomenclature-specification.md)
9
+ > 🌐 **PT**
10
10
 
11
11
  ---
12
12
 
@@ -6,7 +6,7 @@
6
6
 
7
7
  # Guia de Solução de Problemas do SINAPSE
8
8
 
9
- > 🌐 [EN](../troubleshooting.md) | **PT** | [ES](../es/troubleshooting.md)
9
+ > 🌐 [EN](../troubleshooting.md) | **PT**
10
10
 
11
11
  ---
12
12
 
@@ -6,7 +6,7 @@
6
6
 
7
7
  # Guia de Desinstalação
8
8
 
9
- > 🌐 [EN](../uninstallation.md) | **PT** | [ES](../es/uninstallation.md)
9
+ > 🌐 [EN](../installation/uninstallation.md) | **PT**
10
10
 
11
11
  ---
12
12
 
@@ -6,7 +6,7 @@
6
6
 
7
7
  # Como Lançar uma Nova Versão
8
8
 
9
- > 🌐 [EN](../versioning-and-releases.md) | **PT** | [ES](../es/versioning-and-releases.md)
9
+ > 🌐 [EN](../framework/versioning-and-releases.md) | **PT**
10
10
 
11
11
  ---
12
12
 
@@ -148,7 +148,7 @@ Only `@devops` (Pipeline) can execute `git push`. The `enforce-git-push-authorit
148
148
 
149
149
  ## Hook Architecture
150
150
 
151
- SINAPSE-AI uses 19 Claude Code hooks organized by trigger event:
151
+ SINAPSE-AI uses 17 Claude Code hooks organized by trigger event:
152
152
 
153
153
  ### Hook Event Map
154
154
 
@@ -1,6 +1,6 @@
1
1
  # SINAPSE Security Best Practices
2
2
 
3
- > 🌐 **EN** | [PT](./pt/security-best-practices.md) | [ES](./es/security-best-practices.md)
3
+ > 🌐 **EN** | [PT](./pt/security-best-practices.md)
4
4
 
5
5
  ---
6
6
 
@@ -60,7 +60,7 @@ const auth = new AuthSystem({
60
60
  // Create user with strong password requirements
61
61
  await auth.createUser({
62
62
  username: 'admin',
63
- password: 'SecureP@ssw0rd123!',
63
+ password: process.env.ADMIN_PASSWORD, // never hardcode — 12+ chars, mixed case, number, symbol
64
64
  email: 'admin@example.com',
65
65
  role: 'admin'
66
66
  });
@@ -1,6 +1,6 @@
1
1
  # SINAPSE Workflows - Documentação Detalhada dos Workflows
2
2
 
3
- > 🌐 **PT** | [EN](../en/sinapse-workflows/README.md) | [ES](../es/sinapse-workflows/README.md) | [ZH](../zh/sinapse-workflows/README.md)
3
+ > 🌐 **PT** | [EN](../en/sinapse-workflows/README.md) | [ZH](../zh/sinapse-workflows/README.md)
4
4
 
5
5
  ---
6
6
 
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "sinapse-ai",
3
- "version": "1.16.0",
3
+ "version": "1.19.0",
4
4
  "description": "SINAPSE AI: Framework de orquestracao de IA — 17 squads, 172 agentes especializados",
5
5
  "bin": {
6
6
  "sinapse": "bin/sinapse.js",
@@ -138,6 +138,7 @@
138
138
  "validate:story-meta": "node scripts/validate-story-meta.js",
139
139
  "validate:changelog": "node scripts/validate-changelog-tags.js",
140
140
  "validate:squad-orqx": "node scripts/validate-squad-orqx.js",
141
+ "validate:agent-codenames": "node scripts/validate-agent-codenames.js",
141
142
  "validate:release-readiness": "node scripts/release-readiness.js",
142
143
  "manifest:ensure": "node scripts/ensure-manifest.js",
143
144
  "validate:publish": "node bin/utils/validate-publish.js",
@@ -30,6 +30,7 @@
30
30
  "dependencies": {
31
31
  "@clack/prompts": "^0.11.0",
32
32
  "chalk": "^4.1.2",
33
+ "cross-spawn": "^7.0.6",
33
34
  "fs-extra": "^11.3.2"
34
35
  },
35
36
  "devDependencies": {
@@ -11,6 +11,19 @@ const cliProgress = require('cli-progress');
11
11
  const { colors, status, headings } = require('../utils/sinapse-colors');
12
12
  const { t } = require('./i18n');
13
13
 
14
+ /**
15
+ * Canonical ecosystem counts — single, documented source of truth.
16
+ *
17
+ * The numbers come from `scripts/sync-counts.js` (run `npm run sync:counts`):
18
+ * the total is 172 agents — 160 distributed across the 17 squads, plus 12
19
+ * framework core agents. Cross-document consistency is enforced by
20
+ * `npm run validate:article-vii` (Constitution Article VII — Metrics Accuracy).
21
+ *
22
+ * Do NOT inline these numbers elsewhere in this file — reference `ECOSYSTEM`
23
+ * so there is exactly one place to update when `sync:counts` changes.
24
+ */
25
+ const ECOSYSTEM = Object.freeze({ squads: 17, agents: 172, tasks: '1,200' });
26
+
14
27
  /**
15
28
  * Create and start a spinner with SINAPSE styling
16
29
  *
@@ -139,7 +152,7 @@ function showWelcome() {
139
152
  console.log(` ${t('welcomeMessage')}`);
140
153
  console.log(` ${t('welcomeSubtitle')}`);
141
154
  console.log('');
142
- console.log(' 17 squads · 172 agents · 1,200 tasks');
155
+ console.log(` ${ECOSYSTEM.squads} squads · ${ECOSYSTEM.agents} agents · ${ECOSYSTEM.tasks} tasks`);
143
156
  console.log(` ${t('welcomeDesc1')}`);
144
157
  console.log(` ${t('welcomeDesc2')}`);
145
158
  console.log('');
@@ -158,6 +171,9 @@ function showWelcome() {
158
171
  function showCompletion(context = {}) {
159
172
  const llmLabel = context.llmLabel || 'Claude Code';
160
173
  const llmValue = context.llmValue || 'claude-code';
174
+ // Prefer a real count from the caller (manifest/registry) when provided;
175
+ // otherwise fall back to the canonical ECOSYSTEM total (never a magic literal).
176
+ const agentCount = context.agentCount || ECOSYSTEM.agents;
161
177
 
162
178
  let startCommand;
163
179
  if (llmValue === 'codex') {
@@ -175,7 +191,7 @@ function showCompletion(context = {}) {
175
191
  console.log('');
176
192
  console.log(status.success(t('completionInstalled')));
177
193
  console.log(status.success(`${llmLabel} ${t('completionConfigured')}`));
178
- console.log(status.success(`172 ${t('completionAgents')}`));
194
+ console.log(status.success(`${agentCount} ${t('completionAgents')}`));
179
195
  if (depsInstalled) {
180
196
  console.log(status.success(`${t('completionReady')} ${startCommand}`));
181
197
  } else {