@bluefly/openstandardagents 0.2.5-RC → 0.2.8

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 (365) hide show
  1. package/.devfile.yaml +1 -1
  2. package/.env.example +1 -1
  3. package/.github/ISSUE_TEMPLATE/bug_report.yml +63 -0
  4. package/.github/ISSUE_TEMPLATE/feature_request.yml +40 -0
  5. package/.github/workflows/dependabot-comment.yml +34 -0
  6. package/.github/workflows/pr-comment.yml +33 -0
  7. package/.husky/pre-commit +5 -0
  8. package/.kiro/config.json +21 -0
  9. package/.kiro/settings/mcp.json +61 -0
  10. package/.kiro/specs/scripts-migration-api-first/design.md +883 -0
  11. package/.kiro/specs/scripts-migration-api-first/requirements.md +165 -0
  12. package/.kiro/specs/scripts-migration-api-first/tasks.md +539 -0
  13. package/.kiro/specs/{website-design-audit → website-brand-identity}/design.md +381 -0
  14. package/.kiro/specs/{website-design-audit → website-brand-identity}/requirements.md +88 -0
  15. package/.kiro/specs/website-brand-identity/tasks.md +981 -0
  16. package/.version.json +2 -2
  17. package/.wiki-config.json +24 -0
  18. package/CHANGELOG.md +34 -18
  19. package/CODEOWNERS +75 -0
  20. package/CONTRIBUTING.md +1 -1
  21. package/README.md +176 -239
  22. package/bin/ossa-dev +42 -0
  23. package/bin/ossa-export +32 -0
  24. package/bin/ossa-generate +60 -0
  25. package/bin/ossa-health +40 -0
  26. package/bin/ossa-init +26 -0
  27. package/dist/index.d.ts +1 -0
  28. package/dist/index.d.ts.map +1 -1
  29. package/dist/index.js +2 -0
  30. package/dist/index.js.map +1 -1
  31. package/dist/repositories/schema.repository.d.ts +6 -1
  32. package/dist/repositories/schema.repository.d.ts.map +1 -1
  33. package/dist/repositories/schema.repository.js +63 -36
  34. package/dist/repositories/schema.repository.js.map +1 -1
  35. package/dist/services/github-sync/github-client.d.ts +14 -0
  36. package/dist/services/github-sync/github-client.d.ts.map +1 -0
  37. package/dist/services/github-sync/github-client.js +41 -0
  38. package/dist/services/github-sync/github-client.js.map +1 -0
  39. package/dist/services/github-sync/gitlab-client.d.ts +17 -0
  40. package/dist/services/github-sync/gitlab-client.d.ts.map +1 -0
  41. package/dist/services/github-sync/gitlab-client.js +42 -0
  42. package/dist/services/github-sync/gitlab-client.js.map +1 -0
  43. package/dist/services/github-sync/schemas.d.ts +46 -0
  44. package/dist/services/github-sync/schemas.d.ts.map +1 -0
  45. package/dist/services/github-sync/schemas.js +36 -0
  46. package/dist/services/github-sync/schemas.js.map +1 -0
  47. package/dist/services/github-sync/sync.service.d.ts +27 -0
  48. package/dist/services/github-sync/sync.service.d.ts.map +1 -0
  49. package/dist/services/github-sync/sync.service.js +99 -0
  50. package/dist/services/github-sync/sync.service.js.map +1 -0
  51. package/dist/services/migration.service.d.ts +4 -3
  52. package/dist/services/migration.service.d.ts.map +1 -1
  53. package/dist/services/migration.service.js +11 -10
  54. package/dist/services/migration.service.js.map +1 -1
  55. package/dist/services/release-automation/release.service.js +1 -1
  56. package/dist/services/release-automation/release.service.js.map +1 -1
  57. package/dist/services/release-automation/schemas/release.schema.js +1 -1
  58. package/dist/services/runtime/claude/capability-mapper.d.ts +84 -0
  59. package/dist/services/runtime/claude/capability-mapper.d.ts.map +1 -0
  60. package/dist/services/runtime/claude/capability-mapper.js +245 -0
  61. package/dist/services/runtime/claude/capability-mapper.js.map +1 -0
  62. package/dist/services/runtime/claude/claude-adapter.d.ts +80 -0
  63. package/dist/services/runtime/claude/claude-adapter.d.ts.map +1 -0
  64. package/dist/services/runtime/claude/claude-adapter.js +287 -0
  65. package/dist/services/runtime/claude/claude-adapter.js.map +1 -0
  66. package/dist/services/runtime/claude/manifest-parser.d.ts +77 -0
  67. package/dist/services/runtime/claude/manifest-parser.d.ts.map +1 -0
  68. package/dist/services/runtime/claude/manifest-parser.js +169 -0
  69. package/dist/services/runtime/claude/manifest-parser.js.map +1 -0
  70. package/dist/services/runtime/claude/types.d.ts +115 -0
  71. package/dist/services/runtime/claude/types.d.ts.map +1 -0
  72. package/dist/services/runtime/claude/types.js +6 -0
  73. package/dist/services/runtime/claude/types.js.map +1 -0
  74. package/dist/services/validation.service.d.ts.map +1 -1
  75. package/dist/services/validation.service.js +12 -1
  76. package/dist/services/validation.service.js.map +1 -1
  77. package/dist/spec/v0.2.4/ossa-0.2.4.schema.json +85 -208
  78. package/dist/spec/v0.2.6/CHANGELOG.md +401 -0
  79. package/dist/spec/v0.2.6/README.md +72 -0
  80. package/dist/spec/v0.2.6/migrations/v0.2.3-to-v0.2.4.md +599 -0
  81. package/dist/spec/v0.2.6/migrations/v0.2.5-RC-to-v0.2.6.md +65 -0
  82. package/dist/spec/{v0.2.4/ossa-0.2.4-dev.schema.json → v0.2.6/ossa-0.2.6.schema.json} +128 -38
  83. package/dist/spec/v0.2.6/ossa-0.2.6.yaml +581 -0
  84. package/dist/spec/v0.2.6-dev/CHANGELOG.md +164 -0
  85. package/dist/spec/v0.2.6-dev/README.md +75 -0
  86. package/dist/spec/v0.2.6-dev/migrations/v0.2.2-to-v0.2.3.md +343 -0
  87. package/dist/spec/v0.2.6-dev/migrations/v0.2.3-to-v0.2.4.md +599 -0
  88. package/dist/spec/v0.2.6-dev/ossa-0.2.5.yaml +581 -0
  89. package/dist/spec/v0.2.6-dev/ossa-0.2.6-dev.yaml +448 -0
  90. package/dist/spec/v0.2.7/core/agentgraph.md +324 -0
  91. package/dist/spec/v0.2.7/resources/agentgraph.yaml +135 -0
  92. package/dist/spec/v0.2.8/CHANGELOG.md +401 -0
  93. package/dist/spec/v0.2.8/README.md +72 -0
  94. package/dist/spec/v0.2.8/migrations/v0.2.3-to-v0.2.4.md +599 -0
  95. package/dist/spec/v0.2.8/migrations/v0.2.5-RC-to-v0.2.6.md +65 -0
  96. package/dist/spec/v0.2.8/migrations/v0.2.6-to-v0.2.8.md +81 -0
  97. package/dist/spec/v0.2.8/ossa-0.2.8.schema.json +3153 -0
  98. package/dist/spec/v0.2.8/ossa-0.2.8.yaml +581 -0
  99. package/dist/types/index.d.ts +3 -2
  100. package/dist/types/index.d.ts.map +1 -1
  101. package/dist/utils/index.d.ts +6 -0
  102. package/dist/utils/index.d.ts.map +1 -0
  103. package/dist/utils/index.js +6 -0
  104. package/dist/utils/index.js.map +1 -0
  105. package/dist/utils/version.d.ts +68 -0
  106. package/dist/utils/version.d.ts.map +1 -0
  107. package/dist/utils/version.js +156 -0
  108. package/dist/utils/version.js.map +1 -0
  109. package/docs/brand-guide/01-brand-overview.md +37 -0
  110. package/docs/brand-guide/02-logo-usage.md +43 -0
  111. package/docs/brand-guide/03-color-palette.md +70 -0
  112. package/docs/brand-guide/04-typography.md +82 -0
  113. package/docs/brand-guide/05-voice-and-tone.md +108 -0
  114. package/docs/brand-guide/06-visual-elements.md +137 -0
  115. package/docs/brand-guide/07-application-examples.md +153 -0
  116. package/docs/brand-guide/OssaLogo/OssA_Logo.svg +21 -0
  117. package/docs/brand-guide/OssaLogo/brand.af +0 -0
  118. package/docs/brand-guide/README.md +107 -0
  119. package/docs/comparison.md +315 -0
  120. package/docs/operations/automation-roadmap.md +245 -0
  121. package/docs/operations/github-sync-strategy.md +357 -0
  122. package/eslint-report.json +1 -0
  123. package/examples/adk-integration/code-review-workflow.yml +1 -1
  124. package/examples/adk-integration/customer-support.yml +1 -1
  125. package/examples/adk-integration/data-pipeline.yml +1 -1
  126. package/examples/advanced/workflows/hybrid-model-strategy.yaml +1 -1
  127. package/examples/agent-manifests/critics/critic-agent.yaml +1 -1
  128. package/examples/agent-manifests/governors/governor-agent.yaml +1 -1
  129. package/examples/agent-manifests/integrators/integrator-agent.yaml +1 -1
  130. package/examples/agent-manifests/judges/judge-agent.yaml +1 -1
  131. package/examples/agent-manifests/monitors/monitor-agent.yaml +1 -1
  132. package/examples/agent-manifests/orchestrators/orchestrator-agent.yaml +1 -1
  133. package/examples/agent-manifests/sample-compliant-agent.yaml +1 -1
  134. package/examples/agent-manifests/workers/worker-agent.yaml +1 -1
  135. package/examples/anthropic/claude-assistant.ossa.json +5 -4
  136. package/examples/autogen/multi-agent.ossa.json +6 -4
  137. package/examples/claude-code/code-reviewer.ossa.yaml +78 -0
  138. package/examples/claude-code/ossa-validator.ossa.yaml +80 -0
  139. package/examples/common_npm/agent-router.ossa.yaml +1 -0
  140. package/examples/common_npm/agent-router.v0.2.2.ossa.yaml +1 -1
  141. package/examples/crewai/research-team.ossa.json +14 -5
  142. package/examples/cursor/code-review-agent.ossa.json +21 -6
  143. package/examples/drupal/gitlab-ml-recommender.ossa.yaml +1 -0
  144. package/examples/drupal/gitlab-ml-recommender.v0.2.2.ossa.yaml +1 -1
  145. package/examples/extensions/drupal-v1.yml +1 -1
  146. package/examples/extensions/kagent-v1.yml +1 -1
  147. package/examples/getting-started/hello-world-complete.ossa.yaml +1 -1
  148. package/examples/integration-patterns/agent-to-agent-orchestration.ossa.yaml +4 -4
  149. package/examples/kagent/compliance-validator.ossa.yaml +1 -1
  150. package/examples/kagent/cost-optimizer.ossa.yaml +1 -1
  151. package/examples/kagent/documentation-agent.ossa.yaml +1 -1
  152. package/examples/kagent/k8s-troubleshooter-v1.ossa.yaml +1 -0
  153. package/examples/kagent/k8s-troubleshooter-v1.v0.2.2.ossa.yaml +1 -1
  154. package/examples/kagent/k8s-troubleshooter.ossa.yaml +1 -1
  155. package/examples/kagent/security-scanner.ossa.yaml +1 -1
  156. package/examples/langchain/chain-agent.ossa.json +21 -5
  157. package/examples/langflow/workflow-agent.ossa.json +2 -3
  158. package/examples/langgraph/state-machine-agent.ossa.json +2 -3
  159. package/examples/llamaindex/rag-agent.ossa.json +2 -3
  160. package/examples/migration-guides/from-langchain-to-ossa.yaml +4 -4
  161. package/examples/multi-agent/README.md +74 -0
  162. package/examples/multi-agent/conditional-router.ossa.yaml +42 -0
  163. package/examples/multi-agent/parallel-execution.ossa.yaml +54 -0
  164. package/examples/multi-agent/sequential-pipeline.ossa.yaml +45 -0
  165. package/examples/openai/basic-agent.ossa.yaml +1 -1
  166. package/examples/openai/multi-tool-agent.ossa.json +33 -10
  167. package/examples/openai/swarm-agent.ossa.json +18 -5
  168. package/examples/production/document-analyzer-openai.yml +1 -1
  169. package/examples/quickstart/support-agent.ossa.yaml +1 -1
  170. package/examples/spec-examples/audit-agent.yml +1 -1
  171. package/examples/spec-examples/chat-agent.yml +1 -1
  172. package/examples/spec-examples/compliance-agent.yml +1 -1
  173. package/examples/spec-examples/monitoring-agent.yml +1 -1
  174. package/examples/spec-examples/workflow-agent.yml +1 -1
  175. package/examples/templates/ossa-compliance.yaml +1 -1
  176. package/examples/vercel/edge-agent.ossa.json +5 -4
  177. package/gl-code-quality-report.json +62 -0
  178. package/llms-ctx-full.txt +39 -0
  179. package/llms-ctx.txt +39 -0
  180. package/llms.txt +47 -0
  181. package/openapi/github-sync.yaml +115 -0
  182. package/package.json +26 -4
  183. package/scripts/README.md +103 -0
  184. package/scripts/auto-rebase-mrs.ts +106 -0
  185. package/scripts/batch-dependabot.sh +57 -0
  186. package/scripts/configure-gitlab-branch-protection.ts +95 -0
  187. package/scripts/create-issue-helper.ts +238 -0
  188. package/scripts/create-milestone-issue.ts +73 -0
  189. package/scripts/eslint-to-codequality.cjs +34 -0
  190. package/scripts/fix-schema-formats.js +82 -0
  191. package/scripts/generate-agents-catalog.ts +77 -0
  192. package/scripts/generate-api-docs.ts +218 -0
  193. package/scripts/generate-cli-docs.ts +410 -0
  194. package/scripts/generate-config-docs.ts +109 -0
  195. package/scripts/generate-errors-docs.ts +76 -0
  196. package/scripts/generate-examples-docs.ts +99 -0
  197. package/scripts/generate-llms-ctx.sh +17 -0
  198. package/scripts/generate-schema-docs.ts +317 -0
  199. package/scripts/generate-types-docs.ts +48 -0
  200. package/scripts/lowercase-docs.ts +43 -0
  201. package/scripts/manage-milestone-mrs.ts +279 -0
  202. package/scripts/rebase-all-mrs.sh +75 -0
  203. package/scripts/sync-github-pr.sh +48 -0
  204. package/scripts/sync-version.js +32 -0
  205. package/scripts/sync-wiki.sh +50 -0
  206. package/scripts/validate-all.js +127 -0
  207. package/scripts/validate-schema.ts +2 -1
  208. package/spec/v0.2.4/ossa-0.2.4.schema.json +85 -208
  209. package/spec/v0.2.6/CHANGELOG.md +401 -0
  210. package/spec/v0.2.6/README.md +72 -0
  211. package/spec/v0.2.6/migrations/v0.2.3-to-v0.2.4.md +599 -0
  212. package/spec/v0.2.6/migrations/v0.2.5-RC-to-v0.2.6.md +65 -0
  213. package/spec/{v0.2.4/ossa-0.2.4-dev.schema.json → v0.2.6/ossa-0.2.6.schema.json} +128 -38
  214. package/spec/v0.2.6/ossa-0.2.6.yaml +581 -0
  215. package/spec/v0.2.6-dev/CHANGELOG.md +164 -0
  216. package/spec/v0.2.6-dev/README.md +75 -0
  217. package/spec/v0.2.6-dev/migrations/v0.2.2-to-v0.2.3.md +343 -0
  218. package/spec/v0.2.6-dev/migrations/v0.2.3-to-v0.2.4.md +599 -0
  219. package/spec/v0.2.6-dev/ossa-0.2.5.yaml +581 -0
  220. package/spec/v0.2.6-dev/ossa-0.2.6-dev.yaml +448 -0
  221. package/spec/v0.2.7/core/agentgraph.md +324 -0
  222. package/spec/v0.2.7/resources/agentgraph.yaml +135 -0
  223. package/spec/v0.2.8/CHANGELOG.md +401 -0
  224. package/spec/v0.2.8/README.md +72 -0
  225. package/spec/v0.2.8/migrations/v0.2.3-to-v0.2.4.md +599 -0
  226. package/spec/v0.2.8/migrations/v0.2.5-RC-to-v0.2.6.md +65 -0
  227. package/spec/v0.2.8/migrations/v0.2.6-to-v0.2.8.md +81 -0
  228. package/spec/v0.2.8/ossa-0.2.8.schema.json +3153 -0
  229. package/spec/v0.2.8/ossa-0.2.8.yaml +581 -0
  230. package/test-results/junit.xml +299 -0
  231. package/.kiro/specs/agent-buildkit-templates/design.md +0 -495
  232. package/.kiro/specs/agent-buildkit-templates/requirements.md +0 -165
  233. package/.kiro/specs/kiro-ide-supercharger/README.md +0 -202
  234. package/.kiro/specs/kiro-ide-supercharger/design.md +0 -1005
  235. package/.kiro/specs/kiro-ide-supercharger/requirements.md +0 -141
  236. package/.kiro/specs/kiro-ide-supercharger/tasks.md +0 -507
  237. package/bin/validate-ossa-0.2.5-RC.ts +0 -244
  238. package/docs/issue-19-completion-summary.md +0 -648
  239. package/docs/issue-19-validation.md +0 -351
  240. package/scripts/lib/exec.ts +0 -37
  241. package/scripts/lib/file-ops.ts +0 -58
  242. package/scripts/lib/version.ts +0 -83
  243. package/website/.lighthouserc.ts +0 -24
  244. package/website/.prettierrc +0 -10
  245. package/website/Dockerfile +0 -30
  246. package/website/app/about/page.tsx +0 -295
  247. package/website/app/blog/[slug]/page.tsx +0 -208
  248. package/website/app/blog/page.tsx +0 -249
  249. package/website/app/design-guide/page.tsx +0 -511
  250. package/website/app/docs/[[...slug]]/page.tsx +0 -847
  251. package/website/app/docs/core-concepts/project-structure/page.tsx +0 -349
  252. package/website/app/ecosystem/page.tsx +0 -375
  253. package/website/app/examples/page.tsx +0 -133
  254. package/website/app/globals.scss +0 -135
  255. package/website/app/layout.tsx +0 -106
  256. package/website/app/license/page.tsx +0 -183
  257. package/website/app/not-found.tsx +0 -18
  258. package/website/app/page.tsx +0 -474
  259. package/website/app/playground/page.tsx +0 -487
  260. package/website/app/robots.ts +0 -19
  261. package/website/app/rss.xml/route.ts +0 -74
  262. package/website/app/schema/page.tsx +0 -1001
  263. package/website/app/sitemap.ts +0 -56
  264. package/website/app/specification/page.tsx +0 -287
  265. package/website/components/InstallCommand.tsx +0 -96
  266. package/website/components/Logo.tsx +0 -97
  267. package/website/components/StructuredData.tsx +0 -65
  268. package/website/components/docs/DocsSearch.tsx +0 -104
  269. package/website/components/docs/DocsSidebar.tsx +0 -155
  270. package/website/components/docs/MarkdownContent.tsx +0 -401
  271. package/website/components/docs/VersionSelector.tsx +0 -105
  272. package/website/components/examples/ExamplesViewer.tsx +0 -293
  273. package/website/components/layout/Footer.tsx +0 -116
  274. package/website/components/layout/Header.tsx +0 -168
  275. package/website/components/schema/SchemaComponentsAccordion.tsx +0 -84
  276. package/website/components/schema/SchemaExplorer.tsx +0 -213
  277. package/website/content/blog/OpenAPI-AI-Agents-Standard.md +0 -285
  278. package/website/content/blog/Why-Formal-Standards-Matter-Now.md +0 -198
  279. package/website/content/blog/gitlab-kubernetes-agent-ecosystem.md +0 -286
  280. package/website/content/blog/introducing-ossa-framework.md +0 -328
  281. package/website/content/blog/ossa-production-results.md +0 -279
  282. package/website/content/blog/welcome-to-ossa.md +0 -43
  283. package/website/content/blog/why-ai-agents-need-open-standard.md +0 -98
  284. package/website/content/docs/00-HOME.md +0 -153
  285. package/website/content/docs/AIFlow-Framework-Integration-with-OSSA.md +0 -107
  286. package/website/content/docs/Examples.md +0 -71
  287. package/website/content/docs/OpenAPI-Extensions.md +0 -934
  288. package/website/content/docs/adapters/openai-adapter.md +0 -693
  289. package/website/content/docs/architecture/execution-flow.md +0 -335
  290. package/website/content/docs/architecture/multi-agent-systems.md +0 -737
  291. package/website/content/docs/architecture/overview.md +0 -121
  292. package/website/content/docs/architecture/stack-integration.md +0 -461
  293. package/website/content/docs/changelog.md +0 -246
  294. package/website/content/docs/contributing.md +0 -599
  295. package/website/content/docs/core-concepts/Project-Structure.md +0 -348
  296. package/website/content/docs/ecosystem/framework-support.md +0 -819
  297. package/website/content/docs/ecosystem/overview.md +0 -366
  298. package/website/content/docs/examples/AIFlow-Framework-Integration-with-OSSA.md +0 -107
  299. package/website/content/docs/examples/Migration-Guides.md +0 -214
  300. package/website/content/docs/for-audiences/Architects.md +0 -224
  301. package/website/content/docs/for-audiences/Developers.md +0 -220
  302. package/website/content/docs/for-audiences/Enterprises.md +0 -256
  303. package/website/content/docs/for-audiences/Students-Researchers.md +0 -122
  304. package/website/content/docs/getting-started/5-Minute-Overview.md +0 -85
  305. package/website/content/docs/getting-started/First-Agent.md +0 -196
  306. package/website/content/docs/getting-started/Hello-World.md +0 -184
  307. package/website/content/docs/getting-started/Installation.md +0 -155
  308. package/website/content/docs/getting-started/index.md +0 -92
  309. package/website/content/docs/getting-started/running-agents.md +0 -309
  310. package/website/content/docs/getting-started.md +0 -91
  311. package/website/content/docs/integrations/aiflow.md +0 -104
  312. package/website/content/docs/integrations/drupal.md +0 -105
  313. package/website/content/docs/migration-guides/00-INDEX.md +0 -76
  314. package/website/content/docs/migration-guides/README.md +0 -133
  315. package/website/content/docs/migration-guides/agent-schema-comparison.md +0 -232
  316. package/website/content/docs/migration-guides/anthropic-mcp-to-ossa.md +0 -1750
  317. package/website/content/docs/migration-guides/crewai-to-ossa.md +0 -274
  318. package/website/content/docs/migration-guides/drupal-eca-to-ossa.md +0 -2017
  319. package/website/content/docs/migration-guides/general-agent-schema.yml +0 -247
  320. package/website/content/docs/migration-guides/index.md +0 -133
  321. package/website/content/docs/migration-guides/langchain-to-ossa.md +0 -1714
  322. package/website/content/docs/migration-guides/langflow-to-ossa.md +0 -2075
  323. package/website/content/docs/migration-guides/migration-manifest.json +0 -64
  324. package/website/content/docs/migration-guides/openai-to-ossa.md +0 -1202
  325. package/website/content/docs/openapi-extensions/examples.md +0 -550
  326. package/website/content/docs/openapi-extensions/index.md +0 -551
  327. package/website/content/docs/openapi-extensions/operation-extensions.md +0 -457
  328. package/website/content/docs/openapi-extensions/root-extensions.md +0 -410
  329. package/website/content/docs/ossa-compliant-badge.md +0 -251
  330. package/website/content/docs/pre-release/index.md +0 -175
  331. package/website/content/docs/quick-reference.md +0 -17
  332. package/website/content/docs/readme.md +0 -35
  333. package/website/content/docs/schema-reference/agent-spec.md +0 -406
  334. package/website/content/docs/schema-reference/autonomy.md +0 -568
  335. package/website/content/docs/schema-reference/constraints.md +0 -543
  336. package/website/content/docs/schema-reference/index.md +0 -176
  337. package/website/content/docs/schema-reference/llm-config.md +0 -445
  338. package/website/content/docs/schema-reference/observability.md +0 -654
  339. package/website/content/docs/schema-reference/ossa-manifest.md +0 -309
  340. package/website/content/docs/schema-reference/taxonomy.md +0 -509
  341. package/website/content/docs/schema-reference/tools.md +0 -628
  342. package/website/content/docs/templates/blog-post.md +0 -43
  343. package/website/content/docs/use-cases/00-index.md +0 -395
  344. package/website/content/docs/use-cases/cicd-code-review.md +0 -1236
  345. package/website/content/docs/use-cases/customer-support.md +0 -1234
  346. package/website/content/docs/use-cases/enterprise-compliance.md +0 -1208
  347. package/website/content/docs/use-cases/research-multi-agent.md +0 -1161
  348. package/website/content/docs/versioning.md +0 -288
  349. package/website/lib/version.ts +0 -35
  350. package/website/lib/versions.json +0 -78
  351. package/website/next.config.ts +0 -18
  352. package/website/nginx.conf +0 -32
  353. package/website/package-lock.json +0 -9679
  354. package/website/package.json +0 -59
  355. package/website/postcss.config.mjs +0 -9
  356. package/website/scripts/fetch-versions.js +0 -166
  357. package/website/scripts/generate-examples-index.js +0 -163
  358. package/website/scripts/merge-docs-to-wiki.ts +0 -207
  359. package/website/scripts/sync-version.js +0 -72
  360. package/website/scripts/sync-wiki.ts +0 -322
  361. package/website/scripts/upload-wiki.ts +0 -199
  362. package/website/styles/_variables.scss +0 -36
  363. package/website/tailwind.config.ts +0 -136
  364. /package/dist/spec/v0.2.4/{ossa-0.2.4-dev.yaml → ossa-0.2.4.yaml} +0 -0
  365. /package/spec/v0.2.4/{ossa-0.2.4-dev.yaml → ossa-0.2.4.yaml} +0 -0
@@ -1,141 +0,0 @@
1
- # Requirements Document
2
-
3
- ## Introduction
4
-
5
- This feature aims to transform the development environment into a highly optimized, AI-powered development platform by leveraging Kiro's capabilities alongside existing Cursor, VS Code configurations, and MCP (Model Context Protocol) integrations. The goal is to create a comprehensive, **portable** guide and implementation that maximizes developer productivity through intelligent automation, context-aware assistance, and seamless tool integration.
6
-
7
- **Portability**: This spec is designed to be copied to ANY project. All configurations, documentation, and examples are generic and customizable for different tech stacks, frameworks, and workflows.
8
-
9
- ## Glossary
10
-
11
- - **Kiro**: An AI assistant and IDE built to assist developers with autonomous and supervised modes
12
- - **MCP (Model Context Protocol)**: A protocol for connecting AI models with external tools and data sources
13
- - **Cursor**: An AI-powered code editor with advanced context awareness
14
- - **Project**: The software project where this Kiro setup is being used (can be any tech stack)
15
- - **Spec**: A structured way of building and documenting features in Kiro with requirements, design, and implementation tasks
16
- - **Steering**: Context and instructions included in Kiro interactions, stored in `.kiro/steering/*.md`
17
- - **Agent Hook**: Automated agent executions triggered by IDE events (file save, message send, etc.)
18
- - **Property-Based Testing (PBT)**: Testing approach that validates properties across many generated inputs
19
- - **Development Environment**: The complete IDE setup including Kiro, Cursor, VS Code, and all configurations
20
-
21
- ## Requirements
22
-
23
- ### Requirement 1
24
-
25
- **User Story:** As a developer, I want comprehensive documentation of all Kiro capabilities, so that I can understand and leverage every feature available to maximize my productivity.
26
-
27
- #### Acceptance Criteria
28
-
29
- 1. WHEN a developer reviews the documentation THEN the system SHALL provide complete coverage of Kiro's core features including specs, steering, hooks, and MCP integration
30
- 2. WHEN a developer explores feature categories THEN the system SHALL organize capabilities into logical groups (automation, context management, testing, workflow optimization)
31
- 3. WHEN a developer seeks implementation examples THEN the system SHALL provide practical, project-specific examples for each capability
32
- 4. WHEN a developer compares tools THEN the system SHALL clearly explain how Kiro complements existing Cursor and VS Code configurations
33
- 5. WHEN a developer reviews advanced features THEN the system SHALL document MCP server integration, custom tool creation, and multi-agent workflows
34
-
35
- ### Requirement 2
36
-
37
- **User Story:** As a developer, I want intelligent steering rules configured for my project, so that Kiro provides context-aware assistance that understands my project's architecture, standards, and workflows.
38
-
39
- #### Acceptance Criteria
40
-
41
- 1. WHEN Kiro assists with development THEN the system SHALL apply project-specific standards from steering files automatically
42
- 2. WHEN working with project schemas THEN the system SHALL reference schema validation rules and version-specific requirements
43
- 3. WHEN implementing features THEN the system SHALL enforce TDD practices and 95%+ test coverage requirements
44
- 4. WHEN modifying API specs THEN the system SHALL validate against appropriate standards and generate corresponding types
45
- 5. WHERE steering rules apply conditionally THEN the system SHALL activate rules based on file patterns (e.g., schema files, test files, OpenAPI specs)
46
-
47
- ### Requirement 3
48
-
49
- **User Story:** As a developer, I want automated agent hooks configured for common development tasks, so that repetitive workflows are handled automatically without manual intervention.
50
-
51
- #### Acceptance Criteria
52
-
53
- 1. WHEN a developer saves a code file THEN the system SHALL trigger test execution and validation hooks automatically
54
- 2. WHEN schema files are modified THEN the system SHALL regenerate TypeScript types and Zod validators automatically
55
- 3. WHEN OpenAPI specs are updated THEN the system SHALL validate specs and update documentation automatically
56
- 4. WHEN tests fail THEN the system SHALL provide intelligent debugging assistance and suggest fixes
57
- 5. WHEN commits are prepared THEN the system SHALL validate code quality, run linters, and ensure all tests pass
58
-
59
- ### Requirement 4
60
-
61
- **User Story:** As a developer, I want MCP servers configured for my development workflow, so that Kiro can access external tools, databases, and services to provide enhanced assistance.
62
-
63
- #### Acceptance Criteria
64
-
65
- 1. WHEN Kiro needs to access file systems THEN the system SHALL use MCP filesystem servers to read and manipulate files
66
- 2. WHEN Kiro needs to query databases THEN the system SHALL use MCP database servers to execute queries and retrieve data
67
- 3. WHEN Kiro needs to interact with APIs THEN the system SHALL use MCP HTTP servers to make authenticated requests
68
- 4. WHEN Kiro needs to execute commands THEN the system SHALL use MCP command servers with appropriate permissions
69
- 5. WHERE MCP servers require configuration THEN the system SHALL provide clear setup instructions and security guidelines
70
-
71
- ### Requirement 5
72
-
73
- **User Story:** As a developer, I want spec-driven development workflows optimized for my project, so that I can build complex features systematically with clear requirements, design, and implementation plans.
74
-
75
- #### Acceptance Criteria
76
-
77
- 1. WHEN creating a new feature THEN the system SHALL guide through requirements gathering using EARS patterns and INCOSE quality rules
78
- 2. WHEN designing features THEN the system SHALL generate correctness properties for property-based testing
79
- 3. WHEN planning implementation THEN the system SHALL create actionable task lists with clear dependencies and checkpoints
80
- 4. WHEN executing tasks THEN the system SHALL implement one task at a time with proper testing and validation
81
- 5. WHEN tests are written THEN the system SHALL include both unit tests and property-based tests for comprehensive coverage
82
-
83
- ### Requirement 6
84
-
85
- **User Story:** As a developer, I want intelligent context management configured, so that Kiro always has relevant project information without overwhelming token limits.
86
-
87
- #### Acceptance Criteria
88
-
89
- 1. WHEN Kiro assists with code THEN the system SHALL automatically include relevant files based on imports and dependencies
90
- 2. WHEN working with schemas THEN the system SHALL include schema definitions and validation rules in context
91
- 3. WHEN debugging issues THEN the system SHALL include error logs, test results, and related code in context
92
- 4. WHERE context exceeds limits THEN the system SHALL intelligently prioritize most relevant information
93
- 5. WHEN switching between tasks THEN the system SHALL maintain context continuity across conversations
94
-
95
- ### Requirement 7
96
-
97
- **User Story:** As a developer, I want automated testing workflows integrated with Kiro, so that code quality is maintained through continuous validation and intelligent test generation.
98
-
99
- #### Acceptance Criteria
100
-
101
- 1. WHEN implementing new features THEN the system SHALL generate appropriate unit tests and property-based tests
102
- 2. WHEN tests fail THEN the system SHALL analyze failures and suggest fixes based on error messages
103
- 3. WHEN code coverage drops THEN the system SHALL identify untested code paths and generate missing tests
104
- 4. WHEN refactoring code THEN the system SHALL ensure all existing tests continue to pass
105
- 5. WHERE property-based tests are required THEN the system SHALL use fast-check library with minimum 100 iterations
106
-
107
- ### Requirement 8
108
-
109
- **User Story:** As a developer, I want workflow automation for common development tasks, so that repetitive operations are streamlined and error-free.
110
-
111
- #### Acceptance Criteria
112
-
113
- 1. WHEN creating new code artifacts THEN the system SHALL generate compliant code with proper validation
114
- 2. WHEN updating schema versions THEN the system SHALL migrate existing code and update all references
115
- 3. WHEN releasing versions THEN the system SHALL sync versions across package manifests, schemas, and documentation
116
- 4. WHEN validating code THEN the system SHALL check compliance against current project standards
117
- 5. WHEN generating documentation THEN the system SHALL sync content between wiki and documentation sites
118
-
119
- ### Requirement 9
120
-
121
- **User Story:** As a developer, I want integration between Kiro and existing Cursor/VS Code configurations, so that all tools work together seamlessly without conflicts.
122
-
123
- #### Acceptance Criteria
124
-
125
- 1. WHEN Kiro and Cursor are both active THEN the system SHALL coordinate to avoid duplicate actions
126
- 2. WHEN YAML schemas are defined THEN the system SHALL use consistent schema validation across all tools
127
- 3. WHEN formatting code THEN the system SHALL apply consistent Prettier and ESLint rules
128
- 4. WHEN accessing project settings THEN the system SHALL respect existing workspace configurations
129
- 5. WHERE tool-specific features exist THEN the system SHALL leverage each tool's strengths appropriately
130
-
131
- ### Requirement 10
132
-
133
- **User Story:** As a developer, I want advanced MCP capabilities configured, so that I can extend Kiro's functionality with custom tools and integrations specific to my workflow.
134
-
135
- #### Acceptance Criteria
136
-
137
- 1. WHEN custom tools are needed THEN the system SHALL provide templates for creating MCP servers
138
- 2. WHEN integrating with Git platforms THEN the system SHALL use MCP to access repositories, issues, and CI/CD pipelines
139
- 3. WHEN working with infrastructure THEN the system SHALL use MCP to query state and manage deployments
140
- 4. WHEN analyzing code quality THEN the system SHALL use MCP to integrate with linters, formatters, and static analysis tools
141
- 5. WHERE security is required THEN the system SHALL implement proper authentication and authorization for MCP servers
@@ -1,507 +0,0 @@
1
- # Implementation Plan
2
-
3
- - [ ] 1. Create npm package structure for @bluefly/kiro-supercharger
4
- - [ ] 1.1 Initialize npm package
5
- - Create `/Users/flux423/Sites/LLM/common_npm/kiro-supercharger/` directory
6
- - Run `npm init --scope=@bluefly`
7
- - Set up TypeScript configuration
8
- - Add to your common_npm ecosystem
9
- - _Requirements: 1.1, 1.2, 1.3, 1.4, 1.5_
10
-
11
- - [ ] 1.2 Create package structure
12
- - Create `templates/steering/` for steering rule templates
13
- - Create `templates/hooks/` for hook templates
14
- - Create `templates/settings/` for config templates
15
- - Create `templates/specs/` for spec templates
16
- - Create `cli/` for kiro-init command
17
- - Create `docs/` for package documentation
18
- - _Requirements: 1.1, 1.2, 1.3, 1.4, 1.5_
19
-
20
- - [ ] 1.3 Create comprehensive Kiro capabilities documentation in GitLab Wiki
21
- - Create wiki page "Kiro-IDE-Supercharger" explaining all Kiro features
22
- - Include sections on specs, steering, hooks, MCP, and context management
23
- - Provide practical examples for each capability
24
- - Document how Kiro complements Cursor and VS Code
25
- - Document npm package installation and usage
26
- - NO local markdown files - everything goes in the wiki
27
- - _Requirements: 1.1, 1.2, 1.3, 1.4, 1.5_
28
-
29
- - [ ] 2. Create steering rule templates in npm package
30
- - [ ] 2.1 Create project standards steering template
31
- - Write `templates/steering/project-standards.md` with always-included project standards
32
- - Include TDD requirements, testing approach, code quality standards
33
- - Use template variables for customization (e.g., {{PROJECT_NAME}}, {{TEST_FRAMEWORK}})
34
- - Make this generic for TypeScript, Python, Rust, Go, etc.
35
- - _Requirements: 2.1, 2.3_
36
-
37
- - [ ] 2.2 Create schema/type validation steering template
38
- - Write `templates/steering/schema-validation.md` with conditional inclusion
39
- - Use template variables for file patterns (e.g., {{SCHEMA_PATTERN}})
40
- - Include validation rules and type generation workflow
41
- - Make this adaptable to different schema types (JSON Schema, GraphQL, Protobuf, etc.)
42
- - _Requirements: 2.2, 2.5_
43
-
44
- - [ ] 2.3 Create testing requirements steering template
45
- - Write `templates/steering/testing-requirements.md` with TDD and PBT guidelines
46
- - Use template variables for coverage thresholds (e.g., {{COVERAGE_THRESHOLD}})
47
- - Reference property-based testing patterns using fast-check or similar
48
- - Make this generic for any testing framework
49
- - _Requirements: 2.3_
50
-
51
- - [ ] 2.4 Create API workflow steering template
52
- - Write `templates/steering/api-workflow.md` with conditional inclusion
53
- - Use template variables for API spec patterns (e.g., {{API_SPEC_PATTERN}})
54
- - Include validation and type generation workflow
55
- - Make this adaptable to OpenAPI, GraphQL, gRPC, etc.
56
- - _Requirements: 2.4, 2.5_
57
-
58
- - [ ] 2.5 Create Git workflow steering template
59
- - Write `templates/steering/git-workflow.md` with branch protection and commit standards
60
- - Use template variables for Git platform (e.g., {{GIT_PLATFORM}})
61
- - Include pre-commit validation requirements
62
- - Support GitLab, GitHub, Bitbucket
63
- - _Requirements: 2.1_
64
-
65
- - [ ] 2.6 Write property test for steering file loading
66
- - **Property 1: Steering files automatically loaded**
67
- - **Validates: Requirements 2.1**
68
-
69
- - [ ] 2.7 Write property test for conditional steering activation
70
- - **Property 2: Conditional steering activation**
71
- - **Validates: Requirements 2.2, 2.5**
72
-
73
- - [ ] 3. Create agent hook templates in npm package
74
- - [ ] 3.1 Create schema/type change hook template
75
- - Write `templates/hooks/schema-change.hook.json`
76
- - Use template variables for file patterns and commands
77
- - Include examples for common patterns: TypeScript, GraphQL, Protobuf
78
- - Support npm, yarn, pnpm, cargo, poetry
79
- - _Requirements: 3.2_
80
-
81
- - [ ] 3.2 Create test execution hook template
82
- - Write `templates/hooks/test-execution.hook.json`
83
- - Use template variables for test commands
84
- - Support Jest, Vitest, Mocha, pytest, cargo test
85
- - Make this adaptable to different test runners
86
- - _Requirements: 3.1_
87
-
88
- - [ ] 3.3 Create API validation hook template
89
- - Write `templates/hooks/api-validation.hook.json`
90
- - Use template variables for API spec patterns and validation commands
91
- - Support OpenAPI, GraphQL, gRPC validation
92
- - Include doc generation commands
93
- - _Requirements: 3.3_
94
-
95
- - [ ] 3.4 Create pre-commit validation hook template
96
- - Write `templates/hooks/pre-commit.hook.json`
97
- - Use template variables for lint/test commands
98
- - Support multiple linters (ESLint, Prettier, clippy, black, etc.)
99
- - Configure manual trigger
100
- - _Requirements: 3.5_
101
-
102
- - [ ] 3.5 Write property test for hook triggering
103
- - **Property 4: Hook triggering on file save**
104
- - **Validates: Requirements 3.1**
105
-
106
- - [ ] 3.6 Write property test for schema hook
107
- - **Property 5: Schema modification triggers regeneration**
108
- - **Validates: Requirements 3.2**
109
-
110
- - [ ] 3.7 Write property test for OpenAPI hook
111
- - **Property 6: OpenAPI update triggers validation**
112
- - **Validates: Requirements 3.3**
113
-
114
- - [ ] 4. Create MCP configuration templates in npm package
115
- - [ ] 4.1 Create MCP configuration template
116
- - Write `templates/settings/mcp.json` with template variables
117
- - Configure basic structure with mcpServers object
118
- - Use {{WORKSPACE_ROOT}}, {{GIT_PLATFORM}}, {{INFRASTRUCTURE}} variables
119
- - _Requirements: 4.1, 4.2, 4.3, 4.4_
120
-
121
- - [ ] 4.2 Add filesystem MCP server config
122
- - Add filesystem server configuration to mcp.json template
123
- - Use {{WORKSPACE_ROOT}} variable for allowed directories
124
- - Configure uvx command and args
125
- - _Requirements: 4.1_
126
-
127
- - [ ] 4.3 Add Git platform MCP server configs
128
- - Add GitLab, GitHub, Bitbucket server configurations
129
- - Use {{GIT_TOKEN}}, {{GIT_URL}}, {{PROJECT_PATH}} variables
130
- - Include conditional logic for platform selection
131
- - Default to GitLab Ultimate for Bluefly projects
132
- - _Requirements: 4.3, 10.2_
133
-
134
- - [ ] 4.4 Create infrastructure MCP server template
135
- - Write `templates/mcp-servers/infrastructure-server.js`
136
- - Include examples for Kubernetes, Docker, AWS, OrbStack
137
- - Use template variables for infrastructure type
138
- - Make this optional and customizable per project needs
139
- - _Requirements: 4.4, 10.3_
140
-
141
- - [ ] 4.5 Document MCP setup and security in GitLab Wiki
142
- - Create wiki page "MCP-Setup-and-Security" with installation instructions
143
- - Document uv/uvx installation for macOS
144
- - Include security guidelines for credentials and permissions
145
- - NO local markdown files
146
- - _Requirements: 4.5, 10.5_
147
-
148
- - [ ] 4.6 Write property test for MCP filesystem usage
149
- - **Property 8: Filesystem operations use MCP**
150
- - **Validates: Requirements 4.1**
151
-
152
- - [ ] 4.7 Write property test for MCP Git platform usage
153
- - **Property 32: Git platform MCP usage**
154
- - **Validates: Requirements 10.2**
155
-
156
- - [ ] 5. Create spec workflow documentation in GitLab Wiki
157
- - [ ] 5.1 Document spec-driven development workflow
158
- - Create wiki page "Spec-Driven-Development-Workflow"
159
- - Explain requirements → design → tasks → implementation flow
160
- - Include EARS patterns and INCOSE quality rules
161
- - Document property-based testing integration
162
- - _Requirements: 5.1, 5.2, 5.3, 5.4, 5.5_
163
-
164
- - [ ] 5.2 Create spec template files in npm package
165
- - Write `templates/specs/requirements-template.md`
166
- - Write `templates/specs/design-template.md`
167
- - Write `templates/specs/tasks-template.md`
168
- - Include EARS patterns and INCOSE quality rules
169
- - These are actual templates used by Kiro, not documentation
170
- - _Requirements: 5.1, 5.2, 5.3_
171
-
172
- - [ ] 5.3 Document property-based testing approach in GitLab Wiki
173
- - Create wiki page "Property-Based-Testing"
174
- - Explain correctness properties and fast-check usage
175
- - Include generator examples and common patterns
176
- - Document 100+ iteration requirement
177
- - _Requirements: 5.2, 5.5, 7.5_
178
-
179
- - [ ] 5.4 Write property test for EARS pattern enforcement
180
- - **Property 12: EARS pattern enforcement**
181
- - **Validates: Requirements 5.1**
182
-
183
- - [ ] 5.5 Write property test for property generation
184
- - **Property 13: Correctness properties generation**
185
- - **Validates: Requirements 5.2**
186
-
187
- - [ ] 5.6 Write property test for single task execution
188
- - **Property 15: Single task execution**
189
- - **Validates: Requirements 5.4**
190
-
191
- - [ ] 6. Implement context management
192
- - [ ] 6.1 Document context management strategy in GitLab Wiki
193
- - Create wiki page "Context-Management-Strategy"
194
- - Explain import following and depth limits
195
- - Document token budget management and pruning strategies
196
- - Include examples of context assembly
197
- - _Requirements: 6.1, 6.2, 6.3, 6.4, 6.5_
198
-
199
- - [ ] 6.2 Create context configuration template in npm package
200
- - Write `templates/settings/context.json`
201
- - Use template variables for always-included files
202
- - Set import following depth and token limits
203
- - Define priority levels for different file types
204
- - Support different project structures (monorepo, microservices, etc.)
205
- - _Requirements: 6.1, 6.4_
206
-
207
- - [ ] 6.3 Document debugging context patterns in GitLab Wiki
208
- - Add debugging section to "Context-Management-Strategy" wiki page
209
- - Explain how error logs and test results are included
210
- - Provide examples of effective debugging context
211
- - _Requirements: 6.3_
212
-
213
- - [ ] 6.4 Write property test for import following
214
- - **Property 17: Import following**
215
- - **Validates: Requirements 6.1**
216
-
217
- - [ ] 6.5 Write property test for context pruning
218
- - **Property 20: Context pruning priority**
219
- - **Validates: Requirements 6.4**
220
-
221
- - [ ] 7. Create testing workflow documentation in GitLab Wiki
222
- - [ ] 7.1 Document dual testing approach
223
- - Create wiki page "Testing-Strategy"
224
- - Explain unit tests vs property-based tests
225
- - Document when to use each approach
226
- - Include coverage requirements (95%+)
227
- - _Requirements: 7.1, 7.3, 7.4, 7.5_
228
-
229
- - [ ] 7.2 Create test generator templates in npm package
230
- - Write `templates/tests/unit-test-template.ts`
231
- - Write `templates/tests/property-test-template.ts`
232
- - Include fast-check generator examples
233
- - Use template variables for test framework
234
- - Support Jest, Vitest, Mocha, pytest
235
- - _Requirements: 7.1, 7.5_
236
-
237
- - [ ] 7.3 Document coverage analysis workflow in GitLab Wiki
238
- - Add coverage section to "Testing-Strategy" wiki page
239
- - Explain how to identify untested code paths
240
- - Document test generation for coverage gaps
241
- - _Requirements: 7.3_
242
-
243
- - [ ] 7.4 Write property test for dual test generation
244
- - **Property 16: Dual test generation**
245
- - **Validates: Requirements 5.5, 7.1**
246
-
247
- - [ ] 7.5 Write property test for PBT configuration
248
- - **Property 24: PBT configuration**
249
- - **Validates: Requirements 7.5**
250
-
251
- - [ ] 8. Create project workflow automation documentation in GitLab Wiki
252
- - [ ] 8.1 Document code generation workflow
253
- - Create wiki page "Project-Workflows"
254
- - Explain code generation and validation patterns
255
- - Document schema/type compliance checking
256
- - Make this generic for any code generation workflow
257
- - _Requirements: 8.1, 8.4_
258
-
259
- - [ ] 8.2 Document migration workflow
260
- - Add migration section to "Project-Workflows" wiki page
261
- - Explain version update and migration processes
262
- - Document how to migrate project artifacts
263
- - Make this adaptable to different migration needs
264
- - _Requirements: 8.2_
265
-
266
- - [ ] 8.3 Document version synchronization workflow
267
- - Add version sync section to "Project-Workflows" wiki page
268
- - Explain package.json, schema, and docs synchronization
269
- - Provide examples for npm, yarn, pnpm, cargo, etc.
270
- - _Requirements: 8.3_
271
-
272
- - [ ] 8.4 Document documentation sync workflow
273
- - Add docs sync section to "Project-Workflows" wiki page
274
- - Explain wiki/docs synchronization patterns
275
- - Support GitLab wiki, GitHub wiki, Confluence, etc.
276
- - _Requirements: 8.5_
277
-
278
- - [ ] 8.5 Write property test for agent validation
279
- - **Property 25: Agent manifest validation**
280
- - **Validates: Requirements 8.1, 8.4**
281
-
282
- - [ ] 8.6 Write property test for version synchronization
283
- - **Property 27: Version synchronization**
284
- - **Validates: Requirements 8.3**
285
-
286
- - [ ] 9. Create tool integration documentation in GitLab Wiki
287
- - [ ] 9.1 Document Kiro + Cursor + VS Code integration
288
- - Create wiki page "Tool-Integration"
289
- - Explain how tools complement each other
290
- - Document configuration consistency requirements
291
- - Include examples of coordinated workflows
292
- - _Requirements: 9.1, 9.2, 9.3, 9.4, 9.5_
293
-
294
- - [ ] 9.2 Verify schema configuration consistency
295
- - Compare schemas across `.kiro/settings.json`, `.cursor/settings.json`, `.vscode/settings.json`
296
- - Document any differences and reasons in wiki
297
- - Ensure project schemas are consistently referenced
298
- - Make this work for YAML, JSON, GraphQL, etc.
299
- - _Requirements: 9.2_
300
-
301
- - [ ] 9.3 Verify formatter configuration consistency
302
- - Compare Prettier and ESLint configs across tools
303
- - Ensure `.prettierrc.json` and `.eslintrc.cjs` are used by all tools
304
- - Document format-on-save behavior in wiki
305
- - _Requirements: 9.3_
306
-
307
- - [ ] 9.4 Document workspace configuration patterns in GitLab Wiki
308
- - Add workspace config section to "Tool-Integration" wiki page
309
- - Explain how Kiro respects existing settings
310
- - Provide examples of workspace-specific configurations
311
- - _Requirements: 9.4_
312
-
313
- - [ ] 9.5 Write property test for schema configuration consistency
314
- - **Property 29: Schema configuration consistency**
315
- - **Validates: Requirements 9.2**
316
-
317
- - [ ] 9.6 Write property test for formatter consistency
318
- - **Property 30: Formatter consistency**
319
- - **Validates: Requirements 9.3**
320
-
321
- - [ ] 10. Create advanced MCP capabilities documentation in GitLab Wiki
322
- - [ ] 10.1 Create MCP server template in npm package
323
- - Write `templates/mcp-servers/mcp-server-template.js`
324
- - Include basic server structure with tool definitions
325
- - Add authentication and error handling examples
326
- - Use template variables for server name and tools
327
- - This is an actual template file, not documentation
328
- - _Requirements: 10.1_
329
-
330
- - [ ] 10.2 Document Git platform MCP integration in GitLab Wiki
331
- - Create wiki page "MCP-Git-Platforms"
332
- - Explain operations for GitLab, GitHub, Bitbucket (repos, issues, CI/CD)
333
- - Include authentication setup for each platform
334
- - Provide usage examples
335
- - _Requirements: 10.2_
336
-
337
- - [ ] 10.3 Document infrastructure MCP integration in GitLab Wiki
338
- - Create wiki page "MCP-Infrastructure"
339
- - Explain integration patterns for Kubernetes, Docker, AWS, GCP, Azure
340
- - Include authentication and configuration setup
341
- - Provide deployment and monitoring examples
342
- - _Requirements: 10.3_
343
-
344
- - [ ] 10.4 Document code quality MCP integration in GitLab Wiki
345
- - Create wiki page "MCP-Code-Quality"
346
- - Explain linter and static analysis tool integration
347
- - Include ESLint, Prettier, and TypeScript integration
348
- - Provide examples of automated code quality checks
349
- - _Requirements: 10.4_
350
-
351
- - [ ] 10.5 Document MCP security best practices in GitLab Wiki
352
- - Create wiki page "MCP-Security"
353
- - Explain credential management with environment variables
354
- - Document least-privilege permissions
355
- - Include authentication and authorization patterns
356
- - _Requirements: 10.5_
357
-
358
- - [ ] 10.6 Write property test for MCP security configuration
359
- - **Property 35: MCP security configuration**
360
- - **Validates: Requirements 10.5**
361
-
362
- - [ ] 11. Create master "Kiro Supercharger" guide in GitLab Wiki
363
- - [ ] 11.1 Create comprehensive getting started guide
364
- - Create wiki page "Kiro-Supercharger-Guide" (main landing page)
365
- - Include quick start section with immediate wins
366
- - Organize by use case (automation, testing, context, MCP)
367
- - Add troubleshooting section
368
- - _Requirements: 1.1, 1.2, 1.3, 1.4, 1.5_
369
-
370
- - [ ] 11.2 Create feature comparison matrix
371
- - Add comparison table to "Kiro-Supercharger-Guide" wiki page
372
- - Compare Kiro vs Cursor vs VS Code capabilities
373
- - Highlight when to use each tool
374
- - Show how they work together
375
- - _Requirements: 1.4_
376
-
377
- - [ ] 11.3 Create workflow examples
378
- - Add real-world workflow examples to guide
379
- - Include: schema update workflow, feature development workflow, debugging workflow
380
- - Show complete automation chains
381
- - _Requirements: 1.3_
382
-
383
- - [ ] 11.4 Create quick reference cheat sheet
384
- - Create wiki page "Kiro-Quick-Reference"
385
- - Include common commands and patterns
386
- - Add keyboard shortcuts and tips
387
- - Organize by task type
388
- - _Requirements: 1.1_
389
-
390
- - [ ] 12. Checkpoint - Verify all documentation and configurations
391
- - Ensure all steering files are created and valid
392
- - Verify all agent hooks are configured correctly
393
- - Test MCP server connections
394
- - Validate all documentation is complete and accurate
395
- - Run through example workflows to ensure everything works
396
-
397
- - [ ] 13. Create example workflows and demos in GitLab Wiki
398
- - [ ] 13.1 Create type generation workflow demo
399
- - Create wiki page "Workflow-Type-Generation"
400
- - Show complete flow: edit schema → hooks trigger → types generated → tests run
401
- - Make this work for TypeScript, GraphQL, Protobuf, etc.
402
- - Include terminal output examples
403
- - _Requirements: 3.2, 8.2_
404
-
405
- - [ ] 13.2 Create spec-driven feature development demo
406
- - Create wiki page "Workflow-Spec-Driven-Development"
407
- - Show complete flow: requirements → design → tasks → implementation
408
- - Include property-based testing examples
409
- - Make this generic for any project type
410
- - _Requirements: 5.1, 5.2, 5.3, 5.4, 5.5_
411
-
412
- - [ ] 13.3 Create MCP-enhanced debugging demo
413
- - Create wiki page "Workflow-MCP-Debugging"
414
- - Show how MCP servers enhance debugging capabilities
415
- - Include examples for Git platforms, infrastructure, databases
416
- - Make this adaptable to different MCP server types
417
- - _Requirements: 4.1, 4.2, 4.3, 4.4, 10.2, 10.3_
418
-
419
- - [ ] 13.4 Create automated testing workflow demo
420
- - Create wiki page "Workflow-Automated-Testing"
421
- - Show dual testing approach with unit and property tests
422
- - Include coverage analysis and gap identification
423
- - _Requirements: 7.1, 7.3, 7.4, 7.5_
424
-
425
- - [ ] 14. Final checkpoint - Complete validation
426
- - Run all property-based tests to ensure correctness
427
- - Validate all configurations work together
428
- - Test complete workflows end-to-end
429
- - Ensure all documentation is accurate and up-to-date
430
- - Verify the IDE is now a ROCKETSHIP 🚀
431
-
432
-
433
- - [ ] 15. Create CLI tool for package initialization
434
- - [ ] 15.1 Create kiro-init command
435
- - Write `cli/kiro-init.ts` with Commander.js
436
- - Implement template variable substitution
437
- - Support interactive prompts for configuration
438
- - Generate `.kiro/config.json` pointing to package templates
439
- - _Requirements: 1.1, 1.2, 1.3_
440
-
441
- - [ ] 15.2 Add project detection logic
442
- - Detect project type (TypeScript, Python, Rust, Go, etc.)
443
- - Detect package manager (npm, yarn, pnpm, cargo, poetry, etc.)
444
- - Detect Git platform (GitLab, GitHub, Bitbucket)
445
- - Auto-configure templates based on detection
446
- - _Requirements: 1.1, 1.2_
447
-
448
- - [ ] 15.3 Add override support
449
- - Implement `--override` flag for customizing specific templates
450
- - Create `.kiro/overrides/` directory for project-specific customizations
451
- - Document override precedence (overrides > package templates)
452
- - _Requirements: 1.3_
453
-
454
- - [ ] 15.4 Add update command
455
- - Implement `kiro-update` command to sync with latest package version
456
- - Preserve project-specific overrides during updates
457
- - Show diff of changes before applying
458
- - _Requirements: 1.1_
459
-
460
- - [ ] 16. Publish npm package
461
- - [ ] 16.1 Configure package.json for publishing
462
- - Set up exports for templates and CLI
463
- - Add bin entry for kiro-init command
464
- - Configure files to include in package
465
- - Set up publishConfig for @bluefly scope
466
- - _Requirements: 1.1_
467
-
468
- - [ ] 16.2 Add package documentation
469
- - Create README.md with installation and usage
470
- - Document template variables and customization
471
- - Add examples for common project types
472
- - Include troubleshooting section
473
- - _Requirements: 1.1, 1.2_
474
-
475
- - [ ] 16.3 Set up CI/CD for package
476
- - Add GitLab CI pipeline for testing
477
- - Add automatic publishing to npm on version tags
478
- - Add version bumping automation
479
- - _Requirements: 1.1_
480
-
481
- - [ ] 16.4 Publish to npm registry
482
- - Test package locally with `npm link`
483
- - Publish initial version to npm
484
- - Test installation in sample projects
485
- - _Requirements: 1.1_
486
-
487
- - [ ] 17. Integrate with agent-buildkit
488
- - [ ] 17.1 Add Kiro context support to agent-buildkit
489
- - Modify agent-buildkit to read `.kiro/config.json`
490
- - Add `--use-kiro-context` flag to relevant commands
491
- - Load steering rules and context when flag is used
492
- - _Requirements: 9.1_
493
-
494
- - [ ] 17.2 Add agent-buildkit hooks
495
- - Create hook template for triggering agent-buildkit commands
496
- - Add examples: `buildkit agents validate`, `buildkit agents deploy`
497
- - Document integration patterns
498
- - _Requirements: 3.1, 3.2, 3.3_
499
-
500
- - [ ] 18. Final checkpoint - Package validation
501
- - Install package in all 40 projects
502
- - Verify templates load correctly
503
- - Test CLI initialization and updates
504
- - Validate agent-buildkit integration
505
- - Ensure GitLab Ultimate features work
506
- - Confirm OrbStack/K8s MCP integration
507
- - Verify the IDE is now a ROCKETSHIP 🚀