opencastle 0.31.7 → 0.32.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 (220) hide show
  1. package/README.md +4 -1
  2. package/bin/cli.mjs +15 -0
  3. package/dist/cli/agents.d.ts.map +1 -1
  4. package/dist/cli/agents.js +19 -5
  5. package/dist/cli/agents.js.map +1 -1
  6. package/dist/cli/artifacts-cli.d.ts +3 -0
  7. package/dist/cli/artifacts-cli.d.ts.map +1 -0
  8. package/dist/cli/artifacts-cli.js +36 -0
  9. package/dist/cli/artifacts-cli.js.map +1 -0
  10. package/dist/cli/baselines.d.ts.map +1 -1
  11. package/dist/cli/baselines.js +11 -0
  12. package/dist/cli/baselines.js.map +1 -1
  13. package/dist/cli/convoy/artifacts.d.ts +25 -0
  14. package/dist/cli/convoy/artifacts.d.ts.map +1 -0
  15. package/dist/cli/convoy/artifacts.js +129 -0
  16. package/dist/cli/convoy/artifacts.js.map +1 -0
  17. package/dist/cli/convoy/artifacts.test.d.ts +2 -0
  18. package/dist/cli/convoy/artifacts.test.d.ts.map +1 -0
  19. package/dist/cli/convoy/artifacts.test.js +169 -0
  20. package/dist/cli/convoy/artifacts.test.js.map +1 -0
  21. package/dist/cli/convoy/compaction.d.ts +23 -0
  22. package/dist/cli/convoy/compaction.d.ts.map +1 -0
  23. package/dist/cli/convoy/compaction.js +117 -0
  24. package/dist/cli/convoy/compaction.js.map +1 -0
  25. package/dist/cli/convoy/compaction.test.d.ts +2 -0
  26. package/dist/cli/convoy/compaction.test.d.ts.map +1 -0
  27. package/dist/cli/convoy/compaction.test.js +205 -0
  28. package/dist/cli/convoy/compaction.test.js.map +1 -0
  29. package/dist/cli/convoy/contracts.d.ts +22 -0
  30. package/dist/cli/convoy/contracts.d.ts.map +1 -0
  31. package/dist/cli/convoy/contracts.js +254 -0
  32. package/dist/cli/convoy/contracts.js.map +1 -0
  33. package/dist/cli/convoy/contracts.test.d.ts +2 -0
  34. package/dist/cli/convoy/contracts.test.d.ts.map +1 -0
  35. package/dist/cli/convoy/contracts.test.js +239 -0
  36. package/dist/cli/convoy/contracts.test.js.map +1 -0
  37. package/dist/cli/convoy/dag-analysis.d.ts +40 -0
  38. package/dist/cli/convoy/dag-analysis.d.ts.map +1 -0
  39. package/dist/cli/convoy/dag-analysis.js +282 -0
  40. package/dist/cli/convoy/dag-analysis.js.map +1 -0
  41. package/dist/cli/convoy/dag-analysis.test.d.ts +2 -0
  42. package/dist/cli/convoy/dag-analysis.test.d.ts.map +1 -0
  43. package/dist/cli/convoy/dag-analysis.test.js +289 -0
  44. package/dist/cli/convoy/dag-analysis.test.js.map +1 -0
  45. package/dist/cli/convoy/effort-scaling.d.ts +20 -0
  46. package/dist/cli/convoy/effort-scaling.d.ts.map +1 -0
  47. package/dist/cli/convoy/effort-scaling.js +82 -0
  48. package/dist/cli/convoy/effort-scaling.js.map +1 -0
  49. package/dist/cli/convoy/effort-scaling.test.d.ts +2 -0
  50. package/dist/cli/convoy/effort-scaling.test.d.ts.map +1 -0
  51. package/dist/cli/convoy/effort-scaling.test.js +120 -0
  52. package/dist/cli/convoy/effort-scaling.test.js.map +1 -0
  53. package/dist/cli/convoy/engine.d.ts.map +1 -1
  54. package/dist/cli/convoy/engine.js +280 -6
  55. package/dist/cli/convoy/engine.js.map +1 -1
  56. package/dist/cli/convoy/engine.test.js +155 -18
  57. package/dist/cli/convoy/engine.test.js.map +1 -1
  58. package/dist/cli/convoy/event-schemas.d.ts.map +1 -1
  59. package/dist/cli/convoy/event-schemas.js +55 -0
  60. package/dist/cli/convoy/event-schemas.js.map +1 -1
  61. package/dist/cli/convoy/isolation.d.ts +27 -0
  62. package/dist/cli/convoy/isolation.d.ts.map +1 -0
  63. package/dist/cli/convoy/isolation.js +120 -0
  64. package/dist/cli/convoy/isolation.js.map +1 -0
  65. package/dist/cli/convoy/isolation.test.d.ts +2 -0
  66. package/dist/cli/convoy/isolation.test.d.ts.map +1 -0
  67. package/dist/cli/convoy/isolation.test.js +105 -0
  68. package/dist/cli/convoy/isolation.test.js.map +1 -0
  69. package/dist/cli/convoy/review-stages.d.ts +9 -0
  70. package/dist/cli/convoy/review-stages.d.ts.map +1 -0
  71. package/dist/cli/convoy/review-stages.js +134 -0
  72. package/dist/cli/convoy/review-stages.js.map +1 -0
  73. package/dist/cli/convoy/review-stages.test.d.ts +2 -0
  74. package/dist/cli/convoy/review-stages.test.d.ts.map +1 -0
  75. package/dist/cli/convoy/review-stages.test.js +197 -0
  76. package/dist/cli/convoy/review-stages.test.js.map +1 -0
  77. package/dist/cli/convoy/skill-refinement.d.ts +39 -0
  78. package/dist/cli/convoy/skill-refinement.d.ts.map +1 -0
  79. package/dist/cli/convoy/skill-refinement.js +239 -0
  80. package/dist/cli/convoy/skill-refinement.js.map +1 -0
  81. package/dist/cli/convoy/skill-refinement.test.d.ts +2 -0
  82. package/dist/cli/convoy/skill-refinement.test.d.ts.map +1 -0
  83. package/dist/cli/convoy/skill-refinement.test.js +230 -0
  84. package/dist/cli/convoy/skill-refinement.test.js.map +1 -0
  85. package/dist/cli/convoy/spec-builder.d.ts +1 -0
  86. package/dist/cli/convoy/spec-builder.d.ts.map +1 -1
  87. package/dist/cli/convoy/spec-builder.js +11 -0
  88. package/dist/cli/convoy/spec-builder.js.map +1 -1
  89. package/dist/cli/convoy/spec-builder.test.js +54 -0
  90. package/dist/cli/convoy/spec-builder.test.js.map +1 -1
  91. package/dist/cli/convoy/store.d.ts +3 -2
  92. package/dist/cli/convoy/store.d.ts.map +1 -1
  93. package/dist/cli/convoy/store.js +20 -2
  94. package/dist/cli/convoy/store.js.map +1 -1
  95. package/dist/cli/convoy/store.test.js +15 -15
  96. package/dist/cli/convoy/store.test.js.map +1 -1
  97. package/dist/cli/convoy/tdd-gate.d.ts +15 -0
  98. package/dist/cli/convoy/tdd-gate.d.ts.map +1 -0
  99. package/dist/cli/convoy/tdd-gate.js +119 -0
  100. package/dist/cli/convoy/tdd-gate.js.map +1 -0
  101. package/dist/cli/convoy/tdd-gate.test.d.ts +2 -0
  102. package/dist/cli/convoy/tdd-gate.test.d.ts.map +1 -0
  103. package/dist/cli/convoy/tdd-gate.test.js +227 -0
  104. package/dist/cli/convoy/tdd-gate.test.js.map +1 -0
  105. package/dist/cli/convoy/types.d.ts +91 -0
  106. package/dist/cli/convoy/types.d.ts.map +1 -1
  107. package/dist/cli/convoy/types.js +8 -0
  108. package/dist/cli/convoy/types.js.map +1 -1
  109. package/dist/cli/insights.d.ts +3 -0
  110. package/dist/cli/insights.d.ts.map +1 -0
  111. package/dist/cli/insights.js +94 -0
  112. package/dist/cli/insights.js.map +1 -0
  113. package/dist/cli/lesson.d.ts.map +1 -1
  114. package/dist/cli/lesson.js +7 -0
  115. package/dist/cli/lesson.js.map +1 -1
  116. package/dist/cli/log.d.ts.map +1 -1
  117. package/dist/cli/log.js +7 -0
  118. package/dist/cli/log.js.map +1 -1
  119. package/dist/cli/package-config.d.ts +12 -0
  120. package/dist/cli/package-config.d.ts.map +1 -0
  121. package/dist/cli/package-config.js +37 -0
  122. package/dist/cli/package-config.js.map +1 -0
  123. package/dist/cli/package.d.ts +23 -0
  124. package/dist/cli/package.d.ts.map +1 -0
  125. package/dist/cli/package.js +285 -0
  126. package/dist/cli/package.js.map +1 -0
  127. package/dist/cli/package.test.d.ts +2 -0
  128. package/dist/cli/package.test.d.ts.map +1 -0
  129. package/dist/cli/package.test.js +236 -0
  130. package/dist/cli/package.test.js.map +1 -0
  131. package/dist/cli/pipeline.d.ts +6 -0
  132. package/dist/cli/pipeline.d.ts.map +1 -1
  133. package/dist/cli/pipeline.js +15 -2
  134. package/dist/cli/pipeline.js.map +1 -1
  135. package/dist/cli/run/schema.d.ts.map +1 -1
  136. package/dist/cli/run/schema.js +32 -0
  137. package/dist/cli/run/schema.js.map +1 -1
  138. package/dist/cli/run/schema.test.js +51 -0
  139. package/dist/cli/run/schema.test.js.map +1 -1
  140. package/dist/cli/skills.d.ts +3 -0
  141. package/dist/cli/skills.d.ts.map +1 -0
  142. package/dist/cli/skills.js +107 -0
  143. package/dist/cli/skills.js.map +1 -0
  144. package/dist/cli/types.d.ts +4 -1
  145. package/dist/cli/types.d.ts.map +1 -1
  146. package/dist/dashboard/scripts/etl.d.ts.map +1 -1
  147. package/dist/dashboard/scripts/etl.js +44 -11
  148. package/dist/dashboard/scripts/etl.js.map +1 -1
  149. package/package.json +2 -1
  150. package/src/cli/agents.ts +20 -5
  151. package/src/cli/artifacts-cli.ts +41 -0
  152. package/src/cli/baselines.ts +12 -0
  153. package/src/cli/convoy/artifacts.test.ts +201 -0
  154. package/src/cli/convoy/artifacts.ts +186 -0
  155. package/src/cli/convoy/compaction.test.ts +245 -0
  156. package/src/cli/convoy/compaction.ts +164 -0
  157. package/src/cli/convoy/contracts.test.ts +279 -0
  158. package/src/cli/convoy/contracts.ts +280 -0
  159. package/src/cli/convoy/dag-analysis.test.ts +349 -0
  160. package/src/cli/convoy/dag-analysis.ts +371 -0
  161. package/src/cli/convoy/effort-scaling.test.ts +140 -0
  162. package/src/cli/convoy/effort-scaling.ts +90 -0
  163. package/src/cli/convoy/engine.test.ts +175 -18
  164. package/src/cli/convoy/engine.ts +301 -7
  165. package/src/cli/convoy/event-schemas.ts +55 -0
  166. package/src/cli/convoy/isolation.test.ts +137 -0
  167. package/src/cli/convoy/isolation.ts +165 -0
  168. package/src/cli/convoy/review-stages.test.ts +235 -0
  169. package/src/cli/convoy/review-stages.ts +166 -0
  170. package/src/cli/convoy/skill-refinement.test.ts +277 -0
  171. package/src/cli/convoy/skill-refinement.ts +306 -0
  172. package/src/cli/convoy/spec-builder.test.ts +61 -0
  173. package/src/cli/convoy/spec-builder.ts +9 -0
  174. package/src/cli/convoy/store.test.ts +15 -15
  175. package/src/cli/convoy/store.ts +26 -4
  176. package/src/cli/convoy/tdd-gate.test.ts +281 -0
  177. package/src/cli/convoy/tdd-gate.ts +154 -0
  178. package/src/cli/convoy/types.ts +51 -0
  179. package/src/cli/insights.ts +99 -0
  180. package/src/cli/lesson.ts +8 -0
  181. package/src/cli/log.ts +8 -0
  182. package/src/cli/package-config.ts +48 -0
  183. package/src/cli/package.test.ts +276 -0
  184. package/src/cli/package.ts +329 -0
  185. package/src/cli/pipeline.ts +21 -2
  186. package/src/cli/run/schema.test.ts +58 -0
  187. package/src/cli/run/schema.ts +33 -0
  188. package/src/cli/skills.ts +121 -0
  189. package/src/cli/types.ts +4 -1
  190. package/src/dashboard/dist/_astro/index.D6quLrA6.css +1 -0
  191. package/src/dashboard/dist/data/convoy-list.json +21 -7
  192. package/src/dashboard/dist/data/convoys/demo-api-v2.json +3 -3
  193. package/src/dashboard/dist/data/convoys/demo-auth-revamp.json +5 -5
  194. package/src/dashboard/dist/data/convoys/demo-convoy-1.json +2 -2
  195. package/src/dashboard/dist/data/convoys/demo-convoy-2.json +1 -1
  196. package/src/dashboard/dist/data/convoys/demo-dashboard-ui.json +7 -7
  197. package/src/dashboard/dist/data/convoys/demo-data-pipeline.json +3 -3
  198. package/src/dashboard/dist/data/convoys/demo-deploy-ci.json +2 -2
  199. package/src/dashboard/dist/data/convoys/demo-docs-update.json +2 -2
  200. package/src/dashboard/dist/data/convoys/demo-perf-opt.json +4 -4
  201. package/src/dashboard/dist/index.html +306 -33
  202. package/src/dashboard/node_modules/.vite/deps/_metadata.json +6 -6
  203. package/src/dashboard/public/data/convoy-list.json +21 -7
  204. package/src/dashboard/public/data/convoys/demo-api-v2.json +3 -3
  205. package/src/dashboard/public/data/convoys/demo-auth-revamp.json +5 -5
  206. package/src/dashboard/public/data/convoys/demo-convoy-1.json +2 -2
  207. package/src/dashboard/public/data/convoys/demo-convoy-2.json +1 -1
  208. package/src/dashboard/public/data/convoys/demo-dashboard-ui.json +7 -7
  209. package/src/dashboard/public/data/convoys/demo-data-pipeline.json +3 -3
  210. package/src/dashboard/public/data/convoys/demo-deploy-ci.json +2 -2
  211. package/src/dashboard/public/data/convoys/demo-docs-update.json +2 -2
  212. package/src/dashboard/public/data/convoys/demo-perf-opt.json +4 -4
  213. package/src/dashboard/scripts/etl.test.ts +14 -0
  214. package/src/dashboard/scripts/etl.ts +48 -16
  215. package/src/dashboard/scripts/generate-demo-db.ts +18 -10
  216. package/src/dashboard/src/pages/index.astro +348 -45
  217. package/src/dashboard/src/styles/dashboard.css +56 -0
  218. package/src/orchestrator/prompts/assess-complexity.prompt.md +13 -0
  219. package/src/orchestrator/prompts/generate-convoy.prompt.md +19 -0
  220. package/src/dashboard/dist/_astro/index.BRDFmNzR.css +0 -1
@@ -0,0 +1,254 @@
1
+ export const AGENT_CONTRACTS = {
2
+ 'developer': {
3
+ agent: 'developer',
4
+ required_fields: ['files_changed', 'tests_added', 'summary'],
5
+ optional_fields: [],
6
+ schema: {
7
+ files_changed: { type: 'string[]', description: 'List of file paths created or modified', validation: 'file-paths' },
8
+ tests_added: { type: 'string[]', description: 'List of test file paths added or modified', validation: 'file-paths' },
9
+ summary: { type: 'string', description: 'Brief description of what was implemented', validation: 'non-empty' },
10
+ },
11
+ },
12
+ 'ui-ux-expert': {
13
+ agent: 'ui-ux-expert',
14
+ required_fields: ['files_changed', 'components_created', 'a11y_verified', 'summary'],
15
+ optional_fields: [],
16
+ schema: {
17
+ files_changed: { type: 'string[]', description: 'List of file paths created or modified', validation: 'file-paths' },
18
+ components_created: { type: 'string[]', description: 'List of new component file paths', validation: 'file-paths' },
19
+ a11y_verified: { type: 'boolean', description: 'Whether accessibility was verified' },
20
+ summary: { type: 'string', description: 'Brief description of UI/UX changes', validation: 'non-empty' },
21
+ },
22
+ },
23
+ 'testing-expert': {
24
+ agent: 'testing-expert',
25
+ required_fields: ['test_files', 'coverage_summary', 'summary'],
26
+ optional_fields: [],
27
+ schema: {
28
+ test_files: { type: 'string[]', description: 'List of test file paths created or modified', validation: 'file-paths' },
29
+ coverage_summary: { type: 'string', description: 'Summary of test coverage achieved', validation: 'non-empty' },
30
+ summary: { type: 'string', description: 'Brief description of testing work done', validation: 'non-empty' },
31
+ },
32
+ },
33
+ 'security-expert': {
34
+ agent: 'security-expert',
35
+ required_fields: ['findings', 'severity', 'files_reviewed', 'summary'],
36
+ optional_fields: [],
37
+ schema: {
38
+ findings: { type: 'string[]', description: 'List of security findings or issues found' },
39
+ severity: { type: 'string', description: 'Overall severity level (critical|high|medium|low|none)', validation: 'non-empty' },
40
+ files_reviewed: { type: 'string[]', description: 'List of file paths reviewed', validation: 'file-paths' },
41
+ summary: { type: 'string', description: 'Summary of security review', validation: 'non-empty' },
42
+ },
43
+ },
44
+ 'architect': {
45
+ agent: 'architect',
46
+ required_fields: ['decision', 'alternatives_considered', 'risks', 'summary'],
47
+ optional_fields: [],
48
+ schema: {
49
+ decision: { type: 'string', description: 'The architectural decision made', validation: 'non-empty' },
50
+ alternatives_considered: { type: 'string', description: 'Alternatives that were evaluated', validation: 'non-empty' },
51
+ risks: { type: 'string', description: 'Known risks of the decision', validation: 'non-empty' },
52
+ summary: { type: 'string', description: 'Brief summary of the architectural decision', validation: 'non-empty' },
53
+ },
54
+ },
55
+ 'researcher': {
56
+ agent: 'researcher',
57
+ required_fields: ['findings', 'sources', 'confidence', 'summary'],
58
+ optional_fields: [],
59
+ schema: {
60
+ findings: { type: 'string', description: 'Research findings and conclusions', validation: 'non-empty' },
61
+ sources: { type: 'string[]', description: 'List of sources referenced' },
62
+ confidence: { type: 'string', description: 'Confidence level (high|medium|low) with rationale', validation: 'non-empty' },
63
+ summary: { type: 'string', description: 'Brief summary of research', validation: 'non-empty' },
64
+ },
65
+ },
66
+ 'reviewer': {
67
+ agent: 'reviewer',
68
+ required_fields: ['verdict', 'issues', 'summary'],
69
+ optional_fields: [],
70
+ schema: {
71
+ verdict: { type: 'string', description: 'Review verdict (pass|block|conditional)', validation: 'non-empty' },
72
+ issues: { type: 'string[]', description: 'List of issues found during review' },
73
+ summary: { type: 'string', description: 'Brief review summary', validation: 'non-empty' },
74
+ },
75
+ },
76
+ 'documentation-writer': {
77
+ agent: 'documentation-writer',
78
+ required_fields: ['files_changed', 'summary'],
79
+ optional_fields: [],
80
+ schema: {
81
+ files_changed: { type: 'string[]', description: 'List of documentation file paths created or modified', validation: 'file-paths' },
82
+ summary: { type: 'string', description: 'Brief description of documentation changes', validation: 'non-empty' },
83
+ },
84
+ },
85
+ 'copywriter': {
86
+ agent: 'copywriter',
87
+ required_fields: ['content', 'word_count', 'summary'],
88
+ optional_fields: [],
89
+ schema: {
90
+ content: { type: 'string', description: 'The written content or key excerpts', validation: 'non-empty' },
91
+ word_count: { type: 'number', description: 'Total word count of written content', validation: 'positive-int' },
92
+ summary: { type: 'string', description: 'Brief summary of content created', validation: 'non-empty' },
93
+ },
94
+ },
95
+ 'performance-expert': {
96
+ agent: 'performance-expert',
97
+ required_fields: ['metrics_before', 'metrics_after', 'files_changed', 'summary'],
98
+ optional_fields: [],
99
+ schema: {
100
+ metrics_before: { type: 'object', description: 'Performance metrics before changes' },
101
+ metrics_after: { type: 'object', description: 'Performance metrics after changes' },
102
+ files_changed: { type: 'string[]', description: 'List of file paths created or modified', validation: 'file-paths' },
103
+ summary: { type: 'string', description: 'Summary of performance improvements', validation: 'non-empty' },
104
+ },
105
+ },
106
+ 'database-engineer': {
107
+ agent: 'database-engineer',
108
+ required_fields: ['migrations', 'rls_policies', 'rollback_plan', 'summary'],
109
+ optional_fields: [],
110
+ schema: {
111
+ migrations: { type: 'string[]', description: 'List of migration file paths applied', validation: 'file-paths' },
112
+ rls_policies: { type: 'string[]', description: 'List of RLS policy names added or modified' },
113
+ rollback_plan: { type: 'string', description: 'Steps to roll back the changes if needed', validation: 'non-empty' },
114
+ summary: { type: 'string', description: 'Summary of database changes', validation: 'non-empty' },
115
+ },
116
+ },
117
+ 'devops-expert': {
118
+ agent: 'devops-expert',
119
+ required_fields: ['files_changed', 'env_vars_added', 'summary'],
120
+ optional_fields: [],
121
+ schema: {
122
+ files_changed: { type: 'string[]', description: 'List of file paths created or modified', validation: 'file-paths' },
123
+ env_vars_added: { type: 'string[]', description: 'List of environment variable names added' },
124
+ summary: { type: 'string', description: 'Summary of DevOps changes', validation: 'non-empty' },
125
+ },
126
+ },
127
+ 'api-designer': {
128
+ agent: 'api-designer',
129
+ required_fields: ['endpoints', 'schemas', 'summary'],
130
+ optional_fields: [],
131
+ schema: {
132
+ endpoints: { type: 'string[]', description: 'List of API endpoints designed or modified' },
133
+ schemas: { type: 'string[]', description: 'List of request/response schema names' },
134
+ summary: { type: 'string', description: 'Summary of API design decisions', validation: 'non-empty' },
135
+ },
136
+ },
137
+ 'data-expert': {
138
+ agent: 'data-expert',
139
+ required_fields: ['pipeline_steps', 'files_changed', 'summary'],
140
+ optional_fields: [],
141
+ schema: {
142
+ pipeline_steps: { type: 'string[]', description: 'List of data pipeline steps implemented' },
143
+ files_changed: { type: 'string[]', description: 'List of file paths created or modified', validation: 'file-paths' },
144
+ summary: { type: 'string', description: 'Summary of data engineering work', validation: 'non-empty' },
145
+ },
146
+ },
147
+ 'seo-specialist': {
148
+ agent: 'seo-specialist',
149
+ required_fields: ['files_changed', 'tags_added', 'summary'],
150
+ optional_fields: [],
151
+ schema: {
152
+ files_changed: { type: 'string[]', description: 'List of file paths created or modified', validation: 'file-paths' },
153
+ tags_added: { type: 'string[]', description: 'List of SEO tags or structured data items added' },
154
+ summary: { type: 'string', description: 'Summary of SEO changes', validation: 'non-empty' },
155
+ },
156
+ },
157
+ 'release-manager': {
158
+ agent: 'release-manager',
159
+ required_fields: ['version', 'changelog_entries', 'checks_passed', 'summary'],
160
+ optional_fields: [],
161
+ schema: {
162
+ version: { type: 'string', description: 'The version string being released (e.g. 1.2.3)', validation: 'non-empty' },
163
+ changelog_entries: { type: 'string[]', description: 'List of changelog entries for this release' },
164
+ checks_passed: { type: 'boolean', description: 'Whether all release checks passed' },
165
+ summary: { type: 'string', description: 'Summary of the release', validation: 'non-empty' },
166
+ },
167
+ },
168
+ };
169
+ function applyValidation(field, value, spec, missing) {
170
+ if (spec.validation === 'non-empty') {
171
+ if (typeof value !== 'string' || value.trim() === '') {
172
+ missing.push(field);
173
+ }
174
+ }
175
+ else if (spec.validation === 'file-paths') {
176
+ if (!Array.isArray(value) || !value.every(v => typeof v === 'string')) {
177
+ missing.push(field);
178
+ }
179
+ }
180
+ else if (spec.validation === 'positive-int') {
181
+ if (typeof value !== 'number' || !Number.isFinite(value) || value <= 0) {
182
+ missing.push(field);
183
+ }
184
+ }
185
+ }
186
+ export function validateOutput(agent, output) {
187
+ const contract = AGENT_CONTRACTS[agent.toLowerCase()];
188
+ if (!contract) {
189
+ return { valid: true, missing: [], warnings: ['no_contract_defined'] };
190
+ }
191
+ const blockMatch = output.match(/<!--\s*OUTPUT_CONTRACT\s*([\s\S]*?)-->/);
192
+ if (!blockMatch) {
193
+ return { valid: false, missing: ['__contract_block'], warnings: [] };
194
+ }
195
+ let data;
196
+ try {
197
+ data = JSON.parse(blockMatch[1].trim());
198
+ }
199
+ catch {
200
+ return { valid: false, missing: ['__contract_block'], warnings: ['invalid_json'] };
201
+ }
202
+ const missing = [];
203
+ for (const field of contract.required_fields) {
204
+ if (!(field in data) || data[field] === null || data[field] === undefined) {
205
+ missing.push(field);
206
+ continue;
207
+ }
208
+ const fieldSpec = contract.schema[field];
209
+ if (fieldSpec?.validation) {
210
+ applyValidation(field, data[field], fieldSpec, missing);
211
+ }
212
+ }
213
+ return { valid: missing.length === 0, missing, warnings: [], data };
214
+ }
215
+ export function buildContractInstruction(agent) {
216
+ const contract = AGENT_CONTRACTS[agent.toLowerCase()];
217
+ if (!contract)
218
+ return null;
219
+ const exampleFields = contract.required_fields
220
+ .map(f => {
221
+ const spec = contract.schema[f];
222
+ if (!spec)
223
+ return `"${f}": "..."`;
224
+ if (spec.type === 'string[]')
225
+ return `"${f}": [...]`;
226
+ if (spec.type === 'boolean')
227
+ return `"${f}": true`;
228
+ if (spec.type === 'number')
229
+ return `"${f}": 0`;
230
+ if (spec.type === 'object')
231
+ return `"${f}": {}`;
232
+ return `"${f}": "..."`;
233
+ })
234
+ .join(', ');
235
+ return [
236
+ '## Output Contract (REQUIRED)',
237
+ 'At the END of your response, include an OUTPUT_CONTRACT block:',
238
+ `<!-- OUTPUT_CONTRACT`,
239
+ `{ ${exampleFields} }`,
240
+ `-->`,
241
+ `The following fields are REQUIRED: ${contract.required_fields.join(', ')}`,
242
+ ].join('\n');
243
+ }
244
+ export function buildContractRetryPrompt(result) {
245
+ return [
246
+ 'Your previous output was missing the required OUTPUT_CONTRACT block.',
247
+ 'At the END of your response, include:',
248
+ '<!-- OUTPUT_CONTRACT',
249
+ '{ ... }',
250
+ '-->',
251
+ `Missing fields: ${result.missing.join(', ')}`,
252
+ ].join('\n');
253
+ }
254
+ //# sourceMappingURL=contracts.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"contracts.js","sourceRoot":"","sources":["../../../src/cli/convoy/contracts.ts"],"names":[],"mappings":"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"}
@@ -0,0 +1,2 @@
1
+ export {};
2
+ //# sourceMappingURL=contracts.test.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"contracts.test.d.ts","sourceRoot":"","sources":["../../../src/cli/convoy/contracts.test.ts"],"names":[],"mappings":""}
@@ -0,0 +1,239 @@
1
+ import { describe, it, expect } from 'vitest';
2
+ import { AGENT_CONTRACTS, validateOutput, buildContractInstruction, buildContractRetryPrompt, } from './contracts.js';
3
+ // ── Registry well-formedness ──────────────────────────────────────────────────
4
+ describe('AGENT_CONTRACTS registry', () => {
5
+ it('has entries for all expected agents', () => {
6
+ const expectedAgents = [
7
+ 'developer', 'ui-ux-expert', 'testing-expert', 'security-expert',
8
+ 'architect', 'researcher', 'reviewer', 'documentation-writer',
9
+ 'copywriter', 'performance-expert', 'database-engineer', 'devops-expert',
10
+ 'api-designer', 'data-expert', 'seo-specialist', 'release-manager',
11
+ ];
12
+ for (const agent of expectedAgents) {
13
+ expect(AGENT_CONTRACTS).toHaveProperty(agent);
14
+ }
15
+ });
16
+ it('every contract has non-empty required_fields', () => {
17
+ for (const [key, contract] of Object.entries(AGENT_CONTRACTS)) {
18
+ expect(contract.required_fields.length, `${key} should have required_fields`).toBeGreaterThan(0);
19
+ }
20
+ });
21
+ it('every required field has a schema entry', () => {
22
+ for (const [key, contract] of Object.entries(AGENT_CONTRACTS)) {
23
+ for (const field of contract.required_fields) {
24
+ expect(contract.schema, `${key}.${field} missing schema entry`).toHaveProperty(field);
25
+ }
26
+ }
27
+ });
28
+ it('every schema entry has a valid type', () => {
29
+ const validTypes = new Set(['string', 'string[]', 'number', 'boolean', 'object']);
30
+ for (const [key, contract] of Object.entries(AGENT_CONTRACTS)) {
31
+ for (const [field, spec] of Object.entries(contract.schema)) {
32
+ expect(validTypes.has(spec.type), `${key}.${field} has invalid type "${spec.type}"`).toBe(true);
33
+ }
34
+ }
35
+ });
36
+ it('every schema entry has a description', () => {
37
+ for (const [key, contract] of Object.entries(AGENT_CONTRACTS)) {
38
+ for (const [field, spec] of Object.entries(contract.schema)) {
39
+ expect(spec.description, `${key}.${field} missing description`).toBeTruthy();
40
+ }
41
+ }
42
+ });
43
+ it('all optional_fields arrays are empty', () => {
44
+ for (const [key, contract] of Object.entries(AGENT_CONTRACTS)) {
45
+ expect(contract.optional_fields, `${key} should have empty optional_fields`).toHaveLength(0);
46
+ }
47
+ });
48
+ });
49
+ // ── validateOutput ────────────────────────────────────────────────────────────
50
+ describe('validateOutput', () => {
51
+ it('returns valid for a complete developer contract block', () => {
52
+ const output = `
53
+ Some work done here.
54
+
55
+ <!-- OUTPUT_CONTRACT
56
+ { "files_changed": ["src/foo.ts"], "tests_added": ["src/foo.test.ts"], "summary": "Added foo feature" }
57
+ -->
58
+ `;
59
+ const result = validateOutput('developer', output);
60
+ expect(result.valid).toBe(true);
61
+ expect(result.missing).toHaveLength(0);
62
+ expect(result.warnings).toHaveLength(0);
63
+ expect(result.data).toBeDefined();
64
+ });
65
+ it('returns valid=false with missing __contract_block when no block present', () => {
66
+ const result = validateOutput('developer', 'No contract block here.');
67
+ expect(result.valid).toBe(false);
68
+ expect(result.missing).toContain('__contract_block');
69
+ expect(result.warnings).toHaveLength(0);
70
+ });
71
+ it('returns valid=false with invalid_json warning when JSON is malformed', () => {
72
+ const output = '<!-- OUTPUT_CONTRACT\n{ invalid json }\n-->';
73
+ const result = validateOutput('developer', output);
74
+ expect(result.valid).toBe(false);
75
+ expect(result.missing).toContain('__contract_block');
76
+ expect(result.warnings).toContain('invalid_json');
77
+ });
78
+ it('lists missing required fields', () => {
79
+ const output = '<!-- OUTPUT_CONTRACT\n{ "files_changed": ["src/foo.ts"] }\n-->';
80
+ const result = validateOutput('developer', output);
81
+ expect(result.valid).toBe(false);
82
+ expect(result.missing).toContain('tests_added');
83
+ expect(result.missing).toContain('summary');
84
+ expect(result.missing).not.toContain('files_changed');
85
+ });
86
+ it('returns valid=true with no_contract_defined warning for unknown agent', () => {
87
+ const result = validateOutput('unknown-agent-xyz', 'any output');
88
+ expect(result.valid).toBe(true);
89
+ expect(result.missing).toHaveLength(0);
90
+ expect(result.warnings).toContain('no_contract_defined');
91
+ });
92
+ it('is case-insensitive for agent name lookup', () => {
93
+ const output = '<!-- OUTPUT_CONTRACT\n{ "files_changed": ["src/foo.ts"], "tests_added": [], "summary": "done" }\n-->';
94
+ const result = validateOutput('Developer', output);
95
+ expect(result.valid).toBe(true);
96
+ });
97
+ it('works for all registered agents with minimal valid data', () => {
98
+ const minimalData = {
99
+ 'developer': { files_changed: ['src/foo.ts'], tests_added: ['src/foo.test.ts'], summary: 'done' },
100
+ 'ui-ux-expert': { files_changed: ['src/btn.tsx'], components_created: ['src/btn.tsx'], a11y_verified: true, summary: 'done' },
101
+ 'testing-expert': { test_files: ['src/foo.test.ts'], coverage_summary: '95%', summary: 'done' },
102
+ 'security-expert': { findings: [], severity: 'none', files_reviewed: ['src/auth.ts'], summary: 'done' },
103
+ 'architect': { decision: 'use microservices', alternatives_considered: 'monolith', risks: 'complexity', summary: 'done' },
104
+ 'researcher': { findings: 'found stuff', sources: ['https://example.com'], confidence: 'high', summary: 'done' },
105
+ 'reviewer': { verdict: 'pass', issues: [], summary: 'done' },
106
+ 'documentation-writer': { files_changed: ['docs/readme.md'], summary: 'done' },
107
+ 'copywriter': { content: 'some content', word_count: 50, summary: 'done' },
108
+ 'performance-expert': { metrics_before: {}, metrics_after: {}, files_changed: [], summary: 'done' },
109
+ 'database-engineer': { migrations: [], rls_policies: [], rollback_plan: 'delete rows', summary: 'done' },
110
+ 'devops-expert': { files_changed: [], env_vars_added: [], summary: 'done' },
111
+ 'api-designer': { endpoints: ['/api/v1/resource'], schemas: ['ResourceSchema'], summary: 'done' },
112
+ 'data-expert': { pipeline_steps: ['extract', 'transform'], files_changed: [], summary: 'done' },
113
+ 'seo-specialist': { files_changed: [], tags_added: ['og:title'], summary: 'done' },
114
+ 'release-manager': { version: '1.0.0', changelog_entries: ['feat: new thing'], checks_passed: true, summary: 'done' },
115
+ };
116
+ for (const [agent, data] of Object.entries(minimalData)) {
117
+ const output = `<!-- OUTPUT_CONTRACT\n${JSON.stringify(data)}\n-->`;
118
+ const result = validateOutput(agent, output);
119
+ expect(result.valid, `${agent} should be valid with minimal data`).toBe(true);
120
+ }
121
+ });
122
+ });
123
+ // ── Validation rules ──────────────────────────────────────────────────────────
124
+ describe('validateOutput validation rules', () => {
125
+ it('non-empty rejects empty string for summary', () => {
126
+ const output = '<!-- OUTPUT_CONTRACT\n{ "files_changed": ["src/foo.ts"], "tests_added": [], "summary": "" }\n-->';
127
+ const result = validateOutput('developer', output);
128
+ expect(result.valid).toBe(false);
129
+ expect(result.missing).toContain('summary');
130
+ });
131
+ it('non-empty rejects whitespace-only string for summary', () => {
132
+ const output = '<!-- OUTPUT_CONTRACT\n{ "files_changed": ["src/foo.ts"], "tests_added": [], "summary": " " }\n-->';
133
+ const result = validateOutput('developer', output);
134
+ expect(result.valid).toBe(false);
135
+ expect(result.missing).toContain('summary');
136
+ });
137
+ it('file-paths rejects non-array for files_changed', () => {
138
+ const output = '<!-- OUTPUT_CONTRACT\n{ "files_changed": "src/foo.ts", "tests_added": [], "summary": "done" }\n-->';
139
+ const result = validateOutput('developer', output);
140
+ expect(result.valid).toBe(false);
141
+ expect(result.missing).toContain('files_changed');
142
+ });
143
+ it('file-paths rejects array with non-string values', () => {
144
+ const output = '<!-- OUTPUT_CONTRACT\n{ "files_changed": [1, 2], "tests_added": [], "summary": "done" }\n-->';
145
+ const result = validateOutput('developer', output);
146
+ expect(result.valid).toBe(false);
147
+ expect(result.missing).toContain('files_changed');
148
+ });
149
+ it('file-paths accepts empty array', () => {
150
+ const output = '<!-- OUTPUT_CONTRACT\n{ "files_changed": [], "tests_added": [], "summary": "done" }\n-->';
151
+ const result = validateOutput('developer', output);
152
+ expect(result.valid).toBe(true);
153
+ });
154
+ it('positive-int rejects zero for word_count', () => {
155
+ const output = '<!-- OUTPUT_CONTRACT\n{ "content": "text", "word_count": 0, "summary": "done" }\n-->';
156
+ const result = validateOutput('copywriter', output);
157
+ expect(result.valid).toBe(false);
158
+ expect(result.missing).toContain('word_count');
159
+ });
160
+ it('positive-int rejects negative number for word_count', () => {
161
+ const output = '<!-- OUTPUT_CONTRACT\n{ "content": "text", "word_count": -5, "summary": "done" }\n-->';
162
+ const result = validateOutput('copywriter', output);
163
+ expect(result.valid).toBe(false);
164
+ expect(result.missing).toContain('word_count');
165
+ });
166
+ it('positive-int rejects non-number for word_count', () => {
167
+ const output = '<!-- OUTPUT_CONTRACT\n{ "content": "text", "word_count": "fifty", "summary": "done" }\n-->';
168
+ const result = validateOutput('copywriter', output);
169
+ expect(result.valid).toBe(false);
170
+ expect(result.missing).toContain('word_count');
171
+ });
172
+ it('positive-int accepts valid positive number for word_count', () => {
173
+ const output = '<!-- OUTPUT_CONTRACT\n{ "content": "text", "word_count": 100, "summary": "done" }\n-->';
174
+ const result = validateOutput('copywriter', output);
175
+ expect(result.valid).toBe(true);
176
+ });
177
+ });
178
+ // ── buildContractInstruction ──────────────────────────────────────────────────
179
+ describe('buildContractInstruction', () => {
180
+ it('returns instruction string for known agents', () => {
181
+ const instruction = buildContractInstruction('developer');
182
+ expect(instruction).not.toBeNull();
183
+ expect(instruction).toContain('OUTPUT_CONTRACT');
184
+ expect(instruction).toContain('files_changed');
185
+ expect(instruction).toContain('tests_added');
186
+ expect(instruction).toContain('summary');
187
+ expect(instruction).toContain('REQUIRED');
188
+ });
189
+ it('returns null for unknown agents', () => {
190
+ const instruction = buildContractInstruction('unknown-agent-xyz');
191
+ expect(instruction).toBeNull();
192
+ });
193
+ it('is case-insensitive for agent lookup', () => {
194
+ const instruction = buildContractInstruction('Developer');
195
+ expect(instruction).not.toBeNull();
196
+ });
197
+ it('includes all required fields in the REQUIRED list', () => {
198
+ for (const [agent, contract] of Object.entries(AGENT_CONTRACTS)) {
199
+ const instruction = buildContractInstruction(agent);
200
+ expect(instruction).not.toBeNull();
201
+ for (const field of contract.required_fields) {
202
+ expect(instruction).toContain(field);
203
+ }
204
+ }
205
+ });
206
+ it('includes comment block markers', () => {
207
+ const instruction = buildContractInstruction('developer');
208
+ expect(instruction).toContain('<!-- OUTPUT_CONTRACT');
209
+ expect(instruction).toContain('-->');
210
+ });
211
+ });
212
+ // ── buildContractRetryPrompt ──────────────────────────────────────────────────
213
+ describe('buildContractRetryPrompt', () => {
214
+ it('includes missing field names in the prompt', () => {
215
+ const result = { valid: false, missing: ['files_changed', 'summary'], warnings: [] };
216
+ const prompt = buildContractRetryPrompt(result);
217
+ expect(prompt).toContain('files_changed');
218
+ expect(prompt).toContain('summary');
219
+ });
220
+ it('includes OUTPUT_CONTRACT block template', () => {
221
+ const result = { valid: false, missing: ['__contract_block'], warnings: [] };
222
+ const prompt = buildContractRetryPrompt(result);
223
+ expect(prompt).toContain('OUTPUT_CONTRACT');
224
+ expect(prompt).toContain('-->');
225
+ });
226
+ it('mentions that the previous output was missing the block', () => {
227
+ const result = { valid: false, missing: ['__contract_block'], warnings: [] };
228
+ const prompt = buildContractRetryPrompt(result);
229
+ expect(prompt.toLowerCase()).toContain('missing');
230
+ });
231
+ it('handles multiple missing fields', () => {
232
+ const result = { valid: false, missing: ['field_a', 'field_b', 'field_c'], warnings: [] };
233
+ const prompt = buildContractRetryPrompt(result);
234
+ expect(prompt).toContain('field_a');
235
+ expect(prompt).toContain('field_b');
236
+ expect(prompt).toContain('field_c');
237
+ });
238
+ });
239
+ //# sourceMappingURL=contracts.test.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"contracts.test.js","sourceRoot":"","sources":["../../../src/cli/convoy/contracts.test.ts"],"names":[],"mappings":"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"}
@@ -0,0 +1,40 @@
1
+ import type { ConvoyStore } from './store.js';
2
+ import type { ConvoyRecord, TaskRecord } from './types.js';
3
+ export interface ConvoyPattern {
4
+ name: string;
5
+ task_count_range: [number, number];
6
+ agent_sequence: string[];
7
+ avg_duration_ms: number;
8
+ avg_tokens: number;
9
+ success_rate: number;
10
+ common_failure_agents: string[];
11
+ recommended_concurrency: number;
12
+ sample_size: number;
13
+ }
14
+ export interface AgentPerformance {
15
+ agent: string;
16
+ total_tasks: number;
17
+ success_rate: number;
18
+ avg_duration_ms: number;
19
+ avg_tokens: number;
20
+ avg_retries: number;
21
+ best_file_patterns: string[];
22
+ worst_file_patterns: string[];
23
+ }
24
+ export interface DAGRecommendation {
25
+ patterns: ConvoyPattern[];
26
+ agent_stats: AgentPerformance[];
27
+ insights: string[];
28
+ generated_at: string;
29
+ }
30
+ export declare function extractExecutionHistory(store: ConvoyStore, sinceDays?: number): {
31
+ convoys: ConvoyRecord[];
32
+ tasks: TaskRecord[];
33
+ };
34
+ export declare function clusterConvoys(convoys: ConvoyRecord[], tasks: TaskRecord[]): ConvoyPattern[];
35
+ export declare function analyzeAgentPerformance(tasks: TaskRecord[]): AgentPerformance[];
36
+ export declare function generateInsights(patterns: ConvoyPattern[], agents: AgentPerformance[]): string[];
37
+ export declare function analyzeDAG(store: ConvoyStore, sinceDays?: number): DAGRecommendation;
38
+ export declare function formatInsightsMarkdown(rec: DAGRecommendation): string;
39
+ export declare function formatInsightsJSON(rec: DAGRecommendation): string;
40
+ //# sourceMappingURL=dag-analysis.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"dag-analysis.d.ts","sourceRoot":"","sources":["../../../src/cli/convoy/dag-analysis.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,YAAY,CAAA;AAC7C,OAAO,KAAK,EAAE,YAAY,EAAE,UAAU,EAAE,MAAM,YAAY,CAAA;AAE1D,MAAM,WAAW,aAAa;IAC5B,IAAI,EAAE,MAAM,CAAA;IACZ,gBAAgB,EAAE,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;IAClC,cAAc,EAAE,MAAM,EAAE,CAAA;IACxB,eAAe,EAAE,MAAM,CAAA;IACvB,UAAU,EAAE,MAAM,CAAA;IAClB,YAAY,EAAE,MAAM,CAAA;IACpB,qBAAqB,EAAE,MAAM,EAAE,CAAA;IAC/B,uBAAuB,EAAE,MAAM,CAAA;IAC/B,WAAW,EAAE,MAAM,CAAA;CACpB;AAED,MAAM,WAAW,gBAAgB;IAC/B,KAAK,EAAE,MAAM,CAAA;IACb,WAAW,EAAE,MAAM,CAAA;IACnB,YAAY,EAAE,MAAM,CAAA;IACpB,eAAe,EAAE,MAAM,CAAA;IACvB,UAAU,EAAE,MAAM,CAAA;IAClB,WAAW,EAAE,MAAM,CAAA;IACnB,kBAAkB,EAAE,MAAM,EAAE,CAAA;IAC5B,mBAAmB,EAAE,MAAM,EAAE,CAAA;CAC9B;AAED,MAAM,WAAW,iBAAiB;IAChC,QAAQ,EAAE,aAAa,EAAE,CAAA;IACzB,WAAW,EAAE,gBAAgB,EAAE,CAAA;IAC/B,QAAQ,EAAE,MAAM,EAAE,CAAA;IAClB,YAAY,EAAE,MAAM,CAAA;CACrB;AA0CD,wBAAgB,uBAAuB,CACrC,KAAK,EAAE,WAAW,EAClB,SAAS,SAAK,GACb;IAAE,OAAO,EAAE,YAAY,EAAE,CAAC;IAAC,KAAK,EAAE,UAAU,EAAE,CAAA;CAAE,CAiBlD;AAED,wBAAgB,cAAc,CAC5B,OAAO,EAAE,YAAY,EAAE,EACvB,KAAK,EAAE,UAAU,EAAE,GAClB,aAAa,EAAE,CA0FjB;AAED,wBAAgB,uBAAuB,CAAC,KAAK,EAAE,UAAU,EAAE,GAAG,gBAAgB,EAAE,CAwE/E;AAED,wBAAgB,gBAAgB,CAC9B,QAAQ,EAAE,aAAa,EAAE,EACzB,MAAM,EAAE,gBAAgB,EAAE,GACzB,MAAM,EAAE,CAwCV;AAED,wBAAgB,UAAU,CACxB,KAAK,EAAE,WAAW,EAClB,SAAS,CAAC,EAAE,MAAM,GACjB,iBAAiB,CAYnB;AAED,wBAAgB,sBAAsB,CAAC,GAAG,EAAE,iBAAiB,GAAG,MAAM,CAwCrE;AAED,wBAAgB,kBAAkB,CAAC,GAAG,EAAE,iBAAiB,GAAG,MAAM,CAEjE"}