project-iris 0.0.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 (729) hide show
  1. package/README.md +424 -0
  2. package/dist/bridge/agent-runner.js +190 -0
  3. package/dist/bridge/connector-factory.js +31 -0
  4. package/dist/bridge/connectors/antigravity-connector.js +18 -0
  5. package/dist/bridge/connectors/cursor-connector.js +31 -0
  6. package/dist/bridge/connectors/in-process-connector.js +29 -0
  7. package/dist/bridge/connectors/vscode-connector.js +31 -0
  8. package/dist/bridge/connectors/windsurf-connector.js +23 -0
  9. package/dist/bridge/filesystem-connector.js +110 -0
  10. package/dist/bridge/helper.js +203 -0
  11. package/dist/bridge/types.js +10 -0
  12. package/dist/cli.js +38 -0
  13. package/dist/commands/ask.js +259 -0
  14. package/dist/commands/bridge.js +88 -0
  15. package/dist/commands/develop.js +141 -0
  16. package/dist/commands/doctor.js +102 -0
  17. package/dist/commands/flow.js +301 -0
  18. package/dist/commands/framework.js +273 -0
  19. package/dist/commands/generate.js +59 -0
  20. package/dist/commands/install.js +73 -0
  21. package/dist/commands/pack.js +33 -0
  22. package/dist/commands/phase.js +38 -0
  23. package/dist/commands/run.js +199 -0
  24. package/dist/commands/status.js +114 -0
  25. package/dist/commands/uninstall.js +14 -0
  26. package/dist/commands/use.js +20 -0
  27. package/dist/commands/validate.js +102 -0
  28. package/dist/framework/framework-loader.js +97 -0
  29. package/dist/framework/framework-paths.js +48 -0
  30. package/dist/framework/framework-types.js +15 -0
  31. package/dist/iris/artifact-checker.js +78 -0
  32. package/dist/iris/artifacts/config.js +68 -0
  33. package/dist/iris/artifacts/generator.js +88 -0
  34. package/dist/iris/artifacts/types.js +1 -0
  35. package/dist/iris/bundle.js +44 -0
  36. package/dist/iris/doctrine/collector.js +124 -0
  37. package/dist/iris/fixer.js +149 -0
  38. package/dist/iris/flows/manifest.js +124 -0
  39. package/dist/iris/framework-context.js +49 -0
  40. package/dist/iris/framework-manager.js +215 -0
  41. package/dist/iris/fs/atomic.js +22 -0
  42. package/dist/iris/guard.js +38 -0
  43. package/dist/iris/importers/bmad.js +70 -0
  44. package/dist/iris/importers/index.js +9 -0
  45. package/dist/iris/importers/speckit.js +15 -0
  46. package/dist/iris/importers/specsmd.js +78 -0
  47. package/dist/iris/importers/types.js +8 -0
  48. package/dist/iris/importers/writer.js +139 -0
  49. package/dist/iris/include.js +49 -0
  50. package/dist/iris/installer.js +334 -0
  51. package/dist/iris/interactive/env.js +21 -0
  52. package/dist/iris/interactive/intent-interview.js +345 -0
  53. package/dist/iris/interactive/intent-schema.js +28 -0
  54. package/dist/iris/interactive/interview-io.js +22 -0
  55. package/dist/iris/interview/config.js +71 -0
  56. package/dist/iris/interview/types.js +16 -0
  57. package/dist/iris/interview/utils.js +38 -0
  58. package/dist/iris/manifest.js +54 -0
  59. package/dist/iris/packer.js +325 -0
  60. package/dist/iris/parsers/unit-parser.js +43 -0
  61. package/dist/iris/paths.js +18 -0
  62. package/dist/iris/policy.js +133 -0
  63. package/dist/iris/proc.js +56 -0
  64. package/dist/iris/report.js +53 -0
  65. package/dist/iris/resolver.js +66 -0
  66. package/dist/iris/router.js +114 -0
  67. package/dist/iris/routes.js +189 -0
  68. package/dist/iris/run-state.js +146 -0
  69. package/dist/iris/state.js +113 -0
  70. package/dist/iris/templates.js +70 -0
  71. package/dist/iris/tmp.js +24 -0
  72. package/dist/iris/uninstaller.js +181 -0
  73. package/dist/iris/utils/interpolate.js +42 -0
  74. package/dist/iris/validator.js +391 -0
  75. package/dist/iris/workflow/config.js +51 -0
  76. package/dist/iris/workflow/engine.js +129 -0
  77. package/dist/iris/workflow/steps.js +448 -0
  78. package/dist/iris/workflow/types.js +1 -0
  79. package/dist/lib.js +96 -0
  80. package/dist/utils/exit-codes.js +7 -0
  81. package/dist/workflows/bolt-execution.js +238 -0
  82. package/dist/workflows/bolt-plan.js +192 -0
  83. package/dist/workflows/intent-inception.js +210 -0
  84. package/dist/workflows/reporting.js +74 -0
  85. package/package.json +45 -0
  86. package/src/iris_bundle/.iris/aidlc/README.md +16 -0
  87. package/src/iris_bundle/.iris/aidlc/agents/iris-construction-agent.md +35 -0
  88. package/src/iris_bundle/.iris/aidlc/agents/iris-inception-agent.md +30 -0
  89. package/src/iris_bundle/.iris/aidlc/agents/iris-master-agent.md +35 -0
  90. package/src/iris_bundle/.iris/aidlc/agents/iris-operations-agent.md +29 -0
  91. package/src/iris_bundle/.iris/aidlc/commands/iris-construction-agent.md +18 -0
  92. package/src/iris_bundle/.iris/aidlc/commands/iris-inception-agent.md +18 -0
  93. package/src/iris_bundle/.iris/aidlc/commands/iris-master-agent.md +18 -0
  94. package/src/iris_bundle/.iris/aidlc/commands/iris-operations-agent.md +18 -0
  95. package/src/iris_bundle/.iris/aidlc/context/context-map.md +25 -0
  96. package/src/iris_bundle/.iris/aidlc/context/exclusion-rules.md +13 -0
  97. package/src/iris_bundle/.iris/aidlc/context/load-order.md +25 -0
  98. package/src/iris_bundle/.iris/aidlc/memory/intent-rules.md +9 -0
  99. package/src/iris_bundle/.iris/aidlc/memory/log-rules.md +5 -0
  100. package/src/iris_bundle/.iris/aidlc/memory/memory-bank.yaml +39 -0
  101. package/src/iris_bundle/.iris/aidlc/memory/unit-rules.md +9 -0
  102. package/src/iris_bundle/.iris/aidlc/quick-start.md +24 -0
  103. package/src/iris_bundle/.iris/aidlc/skills/execution/implementation.md +14 -0
  104. package/src/iris_bundle/.iris/aidlc/skills/execution/refactoring.md +13 -0
  105. package/src/iris_bundle/.iris/aidlc/skills/execution/scaffold-generation.md +15 -0
  106. package/src/iris_bundle/.iris/aidlc/skills/governance/escalation.md +13 -0
  107. package/src/iris_bundle/.iris/aidlc/skills/governance/quality-gates.md +14 -0
  108. package/src/iris_bundle/.iris/aidlc/skills/governance/stop-conditions.md +11 -0
  109. package/src/iris_bundle/.iris/aidlc/skills/reasoning/decomposition.md +23 -0
  110. package/src/iris_bundle/.iris/aidlc/skills/reasoning/risk-analysis.md +14 -0
  111. package/src/iris_bundle/.iris/aidlc/skills/reasoning/verification.md +21 -0
  112. package/src/iris_bundle/.iris/aidlc/standards/artifacts-registry.md +38 -0
  113. package/src/iris_bundle/.iris/aidlc/standards/decision-logging.md +16 -0
  114. package/src/iris_bundle/.iris/aidlc/standards/doctrine-structure.md +31 -0
  115. package/src/iris_bundle/.iris/aidlc/standards/documentation-rules.md +15 -0
  116. package/src/iris_bundle/.iris/aidlc/standards/file-structure.md +21 -0
  117. package/src/iris_bundle/.iris/aidlc/standards/naming-conventions.md +18 -0
  118. package/src/iris_bundle/.iris/aidlc/standards/phases-and-gates.md +25 -0
  119. package/src/iris_bundle/.iris/aidlc/standards/routes-and-routing.md +35 -0
  120. package/src/iris_bundle/.iris/aidlc/standards/tool-wrappers.md +32 -0
  121. package/src/iris_bundle/.iris/aidlc/templates/bolt.md +23 -0
  122. package/src/iris_bundle/.iris/aidlc/templates/doctrine-doc-template.md +33 -0
  123. package/src/iris_bundle/.iris/aidlc/templates/intent.md +23 -0
  124. package/src/iris_bundle/.iris/aidlc/templates/log.md +24 -0
  125. package/src/iris_bundle/.iris/aidlc/templates/review.md +21 -0
  126. package/src/iris_bundle/.iris/aidlc/templates/unit.md +31 -0
  127. package/src/iris_bundle/.iris/aidlc/validation/failure-modes.md +16 -0
  128. package/src/iris_bundle/.iris/aidlc/validation/phase-preconditions.md +21 -0
  129. package/src/iris_bundle/.iris/aidlc/validation/quality-checklist.md +20 -0
  130. package/src/iris_bundle/.iris/flows/specs-md/doctrine/templates/requirements.md +18 -0
  131. package/src/iris_bundle/.iris/flows/specs-md/doctrine/templates/system-context.md +17 -0
  132. package/src/iris_bundle/.iris/flows/specs-md/doctrine/templates/unit-briefs/construction.md +16 -0
  133. package/src/iris_bundle/.iris/flows/specs-md/doctrine/templates/unit-briefs/operations.md +14 -0
  134. package/src/iris_bundle/.iris/flows/specs-md/doctrine/templates/units.md +11 -0
  135. package/src/iris_bundle/.iris/flows/specs-md/flow.yaml +8 -0
  136. package/src/iris_bundle/.iris/flows/specs-md/policy.overlay.yaml +26 -0
  137. package/src/iris_bundle/.iris/flows/specs-md/routes.overlay.yaml +16 -0
  138. package/src/iris_bundle/.iris/policy.yaml +27 -0
  139. package/src/iris_bundle/.iris/routes.yaml +98 -0
  140. package/src/iris_bundle/.iris/state.yaml +7 -0
  141. package/src/iris_bundle/.iris/tools/claude/.claude/claude.md +9 -0
  142. package/src/iris_bundle/.iris/tools/claude/.claude/commands/compare-specs.md +203 -0
  143. package/src/iris_bundle/.iris/tools/claude/.claude/commands/iris-construction-agent.md +25 -0
  144. package/src/iris_bundle/.iris/tools/claude/.claude/commands/iris-inception-agent.md +25 -0
  145. package/src/iris_bundle/.iris/tools/claude/.claude/commands/iris-master-agent.md +25 -0
  146. package/src/iris_bundle/.iris/tools/claude/.claude/commands/iris-operations-agent.md +25 -0
  147. package/src/iris_bundle/.iris/tools/codex/AGENTS.md +15 -0
  148. package/src/iris_bundle/.iris/tools/cursor/.cursor/commands/iris-construction-agent.md +25 -0
  149. package/src/iris_bundle/.iris/tools/cursor/.cursor/commands/iris-inception-agent.md +25 -0
  150. package/src/iris_bundle/.iris/tools/cursor/.cursor/commands/iris-master-agent.md +25 -0
  151. package/src/iris_bundle/.iris/tools/cursor/.cursor/commands/iris-operations-agent.md +25 -0
  152. package/src/iris_bundle/.iris/tools/gemini/.gemini/commands/iris-construction-agent.toml +29 -0
  153. package/src/iris_bundle/.iris/tools/gemini/.gemini/commands/iris-inception-agent.toml +29 -0
  154. package/src/iris_bundle/.iris/tools/gemini/.gemini/commands/iris-master-agent.toml +29 -0
  155. package/src/iris_bundle/.iris/tools/gemini/.gemini/commands/iris-operations-agent.toml +29 -0
  156. package/src/iris_bundle/frameworks/iris-core/.claude/claude.md +238 -0
  157. package/src/iris_bundle/frameworks/iris-core/.claude/commands/compare-iris.md +203 -0
  158. package/src/iris_bundle/frameworks/iris-core/.claude/commands/irismd-construction-agent.md +63 -0
  159. package/src/iris_bundle/frameworks/iris-core/.claude/commands/irismd-inception-agent.md +55 -0
  160. package/src/iris_bundle/frameworks/iris-core/.claude/commands/irismd-master-agent.md +47 -0
  161. package/src/iris_bundle/frameworks/iris-core/.claude/commands/irismd-operations-agent.md +77 -0
  162. package/src/iris_bundle/frameworks/iris-core/.github/workflows/claude-code-review.yml +57 -0
  163. package/src/iris_bundle/frameworks/iris-core/.github/workflows/claude.yml +50 -0
  164. package/src/iris_bundle/frameworks/iris-core/.github/workflows/npm-package-ci.yml +46 -0
  165. package/src/iris_bundle/frameworks/iris-core/.github/workflows/npm-package-dev.yml +59 -0
  166. package/src/iris_bundle/frameworks/iris-core/.github/workflows/npm-package-release.yml +107 -0
  167. package/src/iris_bundle/frameworks/iris-core/.github/workflows/vscode-publish.yml +113 -0
  168. package/src/iris_bundle/frameworks/iris-core/.irismd/aidlc/README.md +372 -0
  169. package/src/iris_bundle/frameworks/iris-core/.irismd/aidlc/agents/construction-agent.md +80 -0
  170. package/src/iris_bundle/frameworks/iris-core/.irismd/aidlc/agents/inception-agent.md +97 -0
  171. package/src/iris_bundle/frameworks/iris-core/.irismd/aidlc/agents/master-agent.md +61 -0
  172. package/src/iris_bundle/frameworks/iris-core/.irismd/aidlc/agents/operations-agent.md +89 -0
  173. package/src/iris_bundle/frameworks/iris-core/.irismd/aidlc/commands/construction-agent.md +63 -0
  174. package/src/iris_bundle/frameworks/iris-core/.irismd/aidlc/commands/inception-agent.md +55 -0
  175. package/src/iris_bundle/frameworks/iris-core/.irismd/aidlc/commands/master-agent.md +47 -0
  176. package/src/iris_bundle/frameworks/iris-core/.irismd/aidlc/commands/operations-agent.md +77 -0
  177. package/src/iris_bundle/frameworks/iris-core/.irismd/aidlc/context-config.yaml +67 -0
  178. package/src/iris_bundle/frameworks/iris-core/.irismd/aidlc/memory-bank.yaml +104 -0
  179. package/src/iris_bundle/frameworks/iris-core/.irismd/aidlc/quick-start.md +322 -0
  180. package/src/iris_bundle/frameworks/iris-core/.irismd/aidlc/skills/construction/bolt-list.md +163 -0
  181. package/src/iris_bundle/frameworks/iris-core/.irismd/aidlc/skills/construction/bolt-replan.md +345 -0
  182. package/src/iris_bundle/frameworks/iris-core/.irismd/aidlc/skills/construction/bolt-start.md +442 -0
  183. package/src/iris_bundle/frameworks/iris-core/.irismd/aidlc/skills/construction/bolt-status.md +185 -0
  184. package/src/iris_bundle/frameworks/iris-core/.irismd/aidlc/skills/construction/navigator.md +196 -0
  185. package/src/iris_bundle/frameworks/iris-core/.irismd/aidlc/skills/inception/bolt-plan.md +372 -0
  186. package/src/iris_bundle/frameworks/iris-core/.irismd/aidlc/skills/inception/context.md +171 -0
  187. package/src/iris_bundle/frameworks/iris-core/.irismd/aidlc/skills/inception/intent-create.md +211 -0
  188. package/src/iris_bundle/frameworks/iris-core/.irismd/aidlc/skills/inception/intent-list.md +124 -0
  189. package/src/iris_bundle/frameworks/iris-core/.irismd/aidlc/skills/inception/navigator.md +207 -0
  190. package/src/iris_bundle/frameworks/iris-core/.irismd/aidlc/skills/inception/requirements.md +227 -0
  191. package/src/iris_bundle/frameworks/iris-core/.irismd/aidlc/skills/inception/review.md +248 -0
  192. package/src/iris_bundle/frameworks/iris-core/.irismd/aidlc/skills/inception/story-create.md +304 -0
  193. package/src/iris_bundle/frameworks/iris-core/.irismd/aidlc/skills/inception/units.md +278 -0
  194. package/src/iris_bundle/frameworks/iris-core/.irismd/aidlc/skills/master/analyze-context.md +239 -0
  195. package/src/iris_bundle/frameworks/iris-core/.irismd/aidlc/skills/master/answer-question.md +141 -0
  196. package/src/iris_bundle/frameworks/iris-core/.irismd/aidlc/skills/master/explain-flow.md +158 -0
  197. package/src/iris_bundle/frameworks/iris-core/.irismd/aidlc/skills/master/project-init.md +281 -0
  198. package/src/iris_bundle/frameworks/iris-core/.irismd/aidlc/skills/master/route-request.md +126 -0
  199. package/src/iris_bundle/frameworks/iris-core/.irismd/aidlc/skills/operations/build.md +237 -0
  200. package/src/iris_bundle/frameworks/iris-core/.irismd/aidlc/skills/operations/deploy.md +259 -0
  201. package/src/iris_bundle/frameworks/iris-core/.irismd/aidlc/skills/operations/monitor.md +265 -0
  202. package/src/iris_bundle/frameworks/iris-core/.irismd/aidlc/skills/operations/navigator.md +209 -0
  203. package/src/iris_bundle/frameworks/iris-core/.irismd/aidlc/skills/operations/verify.md +224 -0
  204. package/src/iris_bundle/frameworks/iris-core/.irismd/aidlc/templates/construction/bolt-template.md +226 -0
  205. package/src/iris_bundle/frameworks/iris-core/.irismd/aidlc/templates/construction/bolt-types/ddd-construction-bolt/adr-template.md +49 -0
  206. package/src/iris_bundle/frameworks/iris-core/.irismd/aidlc/templates/construction/bolt-types/ddd-construction-bolt/ddd-01-domain-model-template.md +55 -0
  207. package/src/iris_bundle/frameworks/iris-core/.irismd/aidlc/templates/construction/bolt-types/ddd-construction-bolt/ddd-02-technical-design-template.md +67 -0
  208. package/src/iris_bundle/frameworks/iris-core/.irismd/aidlc/templates/construction/bolt-types/ddd-construction-bolt/ddd-03-test-report-template.md +62 -0
  209. package/src/iris_bundle/frameworks/iris-core/.irismd/aidlc/templates/construction/bolt-types/ddd-construction-bolt.md +528 -0
  210. package/src/iris_bundle/frameworks/iris-core/.irismd/aidlc/templates/construction/bolt-types/simple-construction-bolt.md +347 -0
  211. package/src/iris_bundle/frameworks/iris-core/.irismd/aidlc/templates/construction/bolt-types/spike-bolt.md +240 -0
  212. package/src/iris_bundle/frameworks/iris-core/.irismd/aidlc/templates/construction/construction-log-template.md +129 -0
  213. package/src/iris_bundle/frameworks/iris-core/.irismd/aidlc/templates/construction/standards/coding-standards.md +29 -0
  214. package/src/iris_bundle/frameworks/iris-core/.irismd/aidlc/templates/construction/standards/system-architecture.md +22 -0
  215. package/src/iris_bundle/frameworks/iris-core/.irismd/aidlc/templates/construction/standards/tech-stack.md +19 -0
  216. package/src/iris_bundle/frameworks/iris-core/.irismd/aidlc/templates/inception/inception-log-template.md +134 -0
  217. package/src/iris_bundle/frameworks/iris-core/.irismd/aidlc/templates/inception/project/README.md +55 -0
  218. package/src/iris_bundle/frameworks/iris-core/.irismd/aidlc/templates/inception/requirements-template.md +144 -0
  219. package/src/iris_bundle/frameworks/iris-core/.irismd/aidlc/templates/inception/stories-template.md +38 -0
  220. package/src/iris_bundle/frameworks/iris-core/.irismd/aidlc/templates/inception/story-template.md +147 -0
  221. package/src/iris_bundle/frameworks/iris-core/.irismd/aidlc/templates/inception/system-context-template.md +29 -0
  222. package/src/iris_bundle/frameworks/iris-core/.irismd/aidlc/templates/inception/unit-brief-template.md +177 -0
  223. package/src/iris_bundle/frameworks/iris-core/.irismd/aidlc/templates/inception/units-template.md +52 -0
  224. package/src/iris_bundle/frameworks/iris-core/.irismd/aidlc/templates/standards/catalog.yaml +345 -0
  225. package/src/iris_bundle/frameworks/iris-core/.irismd/aidlc/templates/standards/coding-standards.guide.md +553 -0
  226. package/src/iris_bundle/frameworks/iris-core/.irismd/aidlc/templates/standards/data-stack.guide.md +162 -0
  227. package/src/iris_bundle/frameworks/iris-core/.irismd/aidlc/templates/standards/tech-stack.guide.md +280 -0
  228. package/src/iris_bundle/frameworks/iris-core/.markdownlint.yaml +142 -0
  229. package/src/iris_bundle/frameworks/iris-core/LICENSE +21 -0
  230. package/src/iris_bundle/frameworks/iris-core/PRIVACY.md +38 -0
  231. package/src/iris_bundle/frameworks/iris-core/README.md +397 -0
  232. package/src/iris_bundle/frameworks/iris-core/_iris_legacy/framework.yaml +4 -0
  233. package/src/iris_bundle/frameworks/iris-core/_iris_legacy/interview.yaml +9 -0
  234. package/src/iris_bundle/frameworks/iris-core/_iris_legacy/pack.yaml +2 -0
  235. package/src/iris_bundle/frameworks/iris-core/_iris_legacy/policy.yaml +27 -0
  236. package/src/iris_bundle/frameworks/iris-core/_iris_legacy/routes.yaml +98 -0
  237. package/src/iris_bundle/frameworks/iris-core/_iris_legacy/templates/bolt.md +23 -0
  238. package/src/iris_bundle/frameworks/iris-core/_iris_legacy/templates/doctrine-doc-template.md +33 -0
  239. package/src/iris_bundle/frameworks/iris-core/_iris_legacy/templates/intent.md +23 -0
  240. package/src/iris_bundle/frameworks/iris-core/_iris_legacy/templates/log.md +24 -0
  241. package/src/iris_bundle/frameworks/iris-core/_iris_legacy/templates/review.md +21 -0
  242. package/src/iris_bundle/frameworks/iris-core/_iris_legacy/templates/unit.md +31 -0
  243. package/src/iris_bundle/frameworks/iris-core/artifacts.yaml +78 -0
  244. package/src/iris_bundle/frameworks/iris-core/dev_release_guide.md +324 -0
  245. package/src/iris_bundle/frameworks/iris-core/docs.iris.md/.claude/skills/frontend-design/SKILL.md +106 -0
  246. package/src/iris_bundle/frameworks/iris-core/docs.iris.md/CLAUDE.md +171 -0
  247. package/src/iris_bundle/frameworks/iris-core/docs.iris.md/README.md +20 -0
  248. package/src/iris_bundle/frameworks/iris-core/docs.iris.md/agents/construction-agent.mdx +358 -0
  249. package/src/iris_bundle/frameworks/iris-core/docs.iris.md/agents/inception-agent.mdx +306 -0
  250. package/src/iris_bundle/frameworks/iris-core/docs.iris.md/agents/master-agent.mdx +230 -0
  251. package/src/iris_bundle/frameworks/iris-core/docs.iris.md/agents/operations-agent.mdx +344 -0
  252. package/src/iris_bundle/frameworks/iris-core/docs.iris.md/agents/overview.mdx +187 -0
  253. package/src/iris_bundle/frameworks/iris-core/docs.iris.md/architecture/flows.mdx +136 -0
  254. package/src/iris_bundle/frameworks/iris-core/docs.iris.md/community.mdx +91 -0
  255. package/src/iris_bundle/frameworks/iris-core/docs.iris.md/compare/overview.mdx +167 -0
  256. package/src/iris_bundle/frameworks/iris-core/docs.iris.md/compare/vs-bmad.mdx +167 -0
  257. package/src/iris_bundle/frameworks/iris-core/docs.iris.md/compare/vs-kiro.mdx +208 -0
  258. package/src/iris_bundle/frameworks/iris-core/docs.iris.md/compare/vs-openspec.mdx +140 -0
  259. package/src/iris_bundle/frameworks/iris-core/docs.iris.md/compare/vs-speckit.mdx +146 -0
  260. package/src/iris_bundle/frameworks/iris-core/docs.iris.md/core-concepts/bolts.mdx +268 -0
  261. package/src/iris_bundle/frameworks/iris-core/docs.iris.md/core-concepts/intents.mdx +164 -0
  262. package/src/iris_bundle/frameworks/iris-core/docs.iris.md/core-concepts/memory-bank.mdx +209 -0
  263. package/src/iris_bundle/frameworks/iris-core/docs.iris.md/core-concepts/standards.mdx +277 -0
  264. package/src/iris_bundle/frameworks/iris-core/docs.iris.md/core-concepts/units.mdx +184 -0
  265. package/src/iris_bundle/frameworks/iris-core/docs.iris.md/docs.json +148 -0
  266. package/src/iris_bundle/frameworks/iris-core/docs.iris.md/faq.mdx +364 -0
  267. package/src/iris_bundle/frameworks/iris-core/docs.iris.md/feedback.mdx +55 -0
  268. package/src/iris_bundle/frameworks/iris-core/docs.iris.md/getting-started/installation.mdx +91 -0
  269. package/src/iris_bundle/frameworks/iris-core/docs.iris.md/getting-started/quick-start.mdx +149 -0
  270. package/src/iris_bundle/frameworks/iris-core/docs.iris.md/getting-started/vscode-extension.mdx +180 -0
  271. package/src/iris_bundle/frameworks/iris-core/docs.iris.md/guides/bolt-types.mdx +182 -0
  272. package/src/iris_bundle/frameworks/iris-core/docs.iris.md/images/extension-gallery/bolts.jpeg +0 -0
  273. package/src/iris_bundle/frameworks/iris-core/docs.iris.md/images/extension-gallery/overview.jpeg +0 -0
  274. package/src/iris_bundle/frameworks/iris-core/docs.iris.md/images/extension-gallery/specs.jpeg +0 -0
  275. package/src/iris_bundle/frameworks/iris-core/docs.iris.md/images/extension-preview.png +0 -0
  276. package/src/iris_bundle/frameworks/iris-core/docs.iris.md/images/favicon.png +0 -0
  277. package/src/iris_bundle/frameworks/iris-core/docs.iris.md/images/hero-dark.svg +129 -0
  278. package/src/iris_bundle/frameworks/iris-core/docs.iris.md/images/hero-light.svg +129 -0
  279. package/src/iris_bundle/frameworks/iris-core/docs.iris.md/images/logo.png +0 -0
  280. package/src/iris_bundle/frameworks/iris-core/docs.iris.md/images/old_favicon.svg +40 -0
  281. package/src/iris_bundle/frameworks/iris-core/docs.iris.md/images/quickstart.cast +3788 -0
  282. package/src/iris_bundle/frameworks/iris-core/docs.iris.md/images/quickstart.gif +0 -0
  283. package/src/iris_bundle/frameworks/iris-core/docs.iris.md/index.mdx +179 -0
  284. package/src/iris_bundle/frameworks/iris-core/docs.iris.md/methodology/ai-dlc-vs-agile.mdx +138 -0
  285. package/src/iris_bundle/frameworks/iris-core/docs.iris.md/methodology/sdlc-reimagined.mdx +270 -0
  286. package/src/iris_bundle/frameworks/iris-core/docs.iris.md/methodology/three-phases.mdx +225 -0
  287. package/src/iris_bundle/frameworks/iris-core/docs.iris.md/methodology/what-is-ai-dlc.mdx +96 -0
  288. package/src/iris_bundle/frameworks/iris-core/framework.yaml +4 -0
  289. package/src/iris_bundle/frameworks/iris-core/images/763995.png +0 -0
  290. package/src/iris_bundle/frameworks/iris-core/images/763995.svg +354 -0
  291. package/src/iris_bundle/frameworks/iris-core/images/favicon-64.png +0 -0
  292. package/src/iris_bundle/frameworks/iris-core/images/favicon.png +0 -0
  293. package/src/iris_bundle/frameworks/iris-core/images/logo.png +0 -0
  294. package/src/iris_bundle/frameworks/iris-core/images/old_favicon.svg +40 -0
  295. package/src/iris_bundle/frameworks/iris-core/images/specs_md_pixel_logo.png +0 -0
  296. package/src/iris_bundle/frameworks/iris-core/images/specs_md_pixel_logo_big.png +0 -0
  297. package/src/iris_bundle/frameworks/iris-core/interview.yaml +48 -0
  298. package/src/iris_bundle/frameworks/iris-core/memory-bank/PRFAQ.md +193 -0
  299. package/src/iris_bundle/frameworks/iris-core/memory-bank/bolts/016-analytics-tracker/bolt.md +122 -0
  300. package/src/iris_bundle/frameworks/iris-core/memory-bank/bolts/016-analytics-tracker/implementation-plan.md +172 -0
  301. package/src/iris_bundle/frameworks/iris-core/memory-bank/bolts/016-analytics-tracker/implementation-walkthrough.md +56 -0
  302. package/src/iris_bundle/frameworks/iris-core/memory-bank/bolts/016-analytics-tracker/test-walkthrough.md +96 -0
  303. package/src/iris_bundle/frameworks/iris-core/memory-bank/bolts/017-privacy-documentation/bolt.md +72 -0
  304. package/src/iris_bundle/frameworks/iris-core/memory-bank/bolts/bolt-artifact-parser-1/bolt.md +94 -0
  305. package/src/iris_bundle/frameworks/iris-core/memory-bank/bolts/bolt-artifact-parser-1/implementation-plan.md +297 -0
  306. package/src/iris_bundle/frameworks/iris-core/memory-bank/bolts/bolt-artifact-parser-1/implementation-walkthrough.md +56 -0
  307. package/src/iris_bundle/frameworks/iris-core/memory-bank/bolts/bolt-artifact-parser-1/test-walkthrough.md +99 -0
  308. package/src/iris_bundle/frameworks/iris-core/memory-bank/bolts/bolt-artifact-parser-2/bolt.md +88 -0
  309. package/src/iris_bundle/frameworks/iris-core/memory-bank/bolts/bolt-artifact-parser-2/implementation-plan.md +196 -0
  310. package/src/iris_bundle/frameworks/iris-core/memory-bank/bolts/bolt-artifact-parser-2/implementation-walkthrough.md +154 -0
  311. package/src/iris_bundle/frameworks/iris-core/memory-bank/bolts/bolt-artifact-parser-2/test-walkthrough.md +119 -0
  312. package/src/iris_bundle/frameworks/iris-core/memory-bank/bolts/bolt-extension-core-1/bolt.md +99 -0
  313. package/src/iris_bundle/frameworks/iris-core/memory-bank/bolts/bolt-extension-core-1/implementation-plan.md +70 -0
  314. package/src/iris_bundle/frameworks/iris-core/memory-bank/bolts/bolt-extension-core-1/implementation-walkthrough.md +45 -0
  315. package/src/iris_bundle/frameworks/iris-core/memory-bank/bolts/bolt-extension-core-1/test-walkthrough.md +60 -0
  316. package/src/iris_bundle/frameworks/iris-core/memory-bank/bolts/bolt-file-watcher-1/bolt.md +86 -0
  317. package/src/iris_bundle/frameworks/iris-core/memory-bank/bolts/bolt-file-watcher-1/implementation-plan.md +154 -0
  318. package/src/iris_bundle/frameworks/iris-core/memory-bank/bolts/bolt-file-watcher-1/implementation-walkthrough.md +43 -0
  319. package/src/iris_bundle/frameworks/iris-core/memory-bank/bolts/bolt-file-watcher-1/test-walkthrough.md +74 -0
  320. package/src/iris_bundle/frameworks/iris-core/memory-bank/bolts/bolt-sidebar-provider-1/bolt.md +89 -0
  321. package/src/iris_bundle/frameworks/iris-core/memory-bank/bolts/bolt-sidebar-provider-1/implementation-plan.md +76 -0
  322. package/src/iris_bundle/frameworks/iris-core/memory-bank/bolts/bolt-sidebar-provider-1/implementation-walkthrough.md +43 -0
  323. package/src/iris_bundle/frameworks/iris-core/memory-bank/bolts/bolt-sidebar-provider-1/test-walkthrough.md +70 -0
  324. package/src/iris_bundle/frameworks/iris-core/memory-bank/bolts/bolt-sidebar-provider-2/bolt.md +90 -0
  325. package/src/iris_bundle/frameworks/iris-core/memory-bank/bolts/bolt-sidebar-provider-2/implementation-plan.md +93 -0
  326. package/src/iris_bundle/frameworks/iris-core/memory-bank/bolts/bolt-sidebar-provider-2/implementation-walkthrough.md +44 -0
  327. package/src/iris_bundle/frameworks/iris-core/memory-bank/bolts/bolt-sidebar-provider-2/test-walkthrough.md +54 -0
  328. package/src/iris_bundle/frameworks/iris-core/memory-bank/bolts/bolt-sidebar-provider-3/bolt.md +90 -0
  329. package/src/iris_bundle/frameworks/iris-core/memory-bank/bolts/bolt-sidebar-provider-3/implementation-plan.md +168 -0
  330. package/src/iris_bundle/frameworks/iris-core/memory-bank/bolts/bolt-sidebar-provider-3/implementation-walkthrough.md +137 -0
  331. package/src/iris_bundle/frameworks/iris-core/memory-bank/bolts/bolt-sidebar-provider-3/test-walkthrough.md +134 -0
  332. package/src/iris_bundle/frameworks/iris-core/memory-bank/bolts/bolt-sidebar-provider-4/bolt.md +93 -0
  333. package/src/iris_bundle/frameworks/iris-core/memory-bank/bolts/bolt-sidebar-provider-4/implementation-plan.md +176 -0
  334. package/src/iris_bundle/frameworks/iris-core/memory-bank/bolts/bolt-sidebar-provider-4/implementation-walkthrough.md +159 -0
  335. package/src/iris_bundle/frameworks/iris-core/memory-bank/bolts/bolt-sidebar-provider-4/test-walkthrough.md +105 -0
  336. package/src/iris_bundle/frameworks/iris-core/memory-bank/bolts/bolt-sidebar-provider-5/bolt.md +104 -0
  337. package/src/iris_bundle/frameworks/iris-core/memory-bank/bolts/bolt-sidebar-provider-5/implementation-plan.md +146 -0
  338. package/src/iris_bundle/frameworks/iris-core/memory-bank/bolts/bolt-webview-lit-migration-1/bolt.md +83 -0
  339. package/src/iris_bundle/frameworks/iris-core/memory-bank/bolts/bolt-webview-lit-migration-1/implementation-plan.md +161 -0
  340. package/src/iris_bundle/frameworks/iris-core/memory-bank/bolts/bolt-webview-lit-migration-1/implementation-walkthrough.md +58 -0
  341. package/src/iris_bundle/frameworks/iris-core/memory-bank/bolts/bolt-webview-lit-migration-1/test-walkthrough.md +104 -0
  342. package/src/iris_bundle/frameworks/iris-core/memory-bank/bolts/bolt-webview-lit-migration-2/bolt.md +83 -0
  343. package/src/iris_bundle/frameworks/iris-core/memory-bank/bolts/bolt-webview-lit-migration-2/implementation-plan.md +179 -0
  344. package/src/iris_bundle/frameworks/iris-core/memory-bank/bolts/bolt-webview-lit-migration-2/implementation-walkthrough.md +124 -0
  345. package/src/iris_bundle/frameworks/iris-core/memory-bank/bolts/bolt-webview-lit-migration-2/test-walkthrough.md +95 -0
  346. package/src/iris_bundle/frameworks/iris-core/memory-bank/bolts/bolt-webview-lit-migration-3/bolt.md +83 -0
  347. package/src/iris_bundle/frameworks/iris-core/memory-bank/bolts/bolt-webview-lit-migration-3/implementation-plan.md +196 -0
  348. package/src/iris_bundle/frameworks/iris-core/memory-bank/bolts/bolt-webview-lit-migration-3/implementation-walkthrough.md +207 -0
  349. package/src/iris_bundle/frameworks/iris-core/memory-bank/bolts/bolt-webview-lit-migration-3/test-walkthrough.md +194 -0
  350. package/src/iris_bundle/frameworks/iris-core/memory-bank/bolts/bolt-webview-lit-migration-4/bolt.md +92 -0
  351. package/src/iris_bundle/frameworks/iris-core/memory-bank/bolts/bolt-webview-lit-migration-4/implementation-plan.md +217 -0
  352. package/src/iris_bundle/frameworks/iris-core/memory-bank/bolts/bolt-webview-lit-migration-4/implementation-walkthrough.md +138 -0
  353. package/src/iris_bundle/frameworks/iris-core/memory-bank/bolts/bolt-webview-lit-migration-4/test-walkthrough.md +196 -0
  354. package/src/iris_bundle/frameworks/iris-core/memory-bank/bolts/bolt-webview-lit-migration-5/bolt.md +89 -0
  355. package/src/iris_bundle/frameworks/iris-core/memory-bank/bolts/bolt-webview-lit-migration-5/implementation-plan.md +181 -0
  356. package/src/iris_bundle/frameworks/iris-core/memory-bank/bolts/bolt-webview-lit-migration-5/implementation-walkthrough.md +160 -0
  357. package/src/iris_bundle/frameworks/iris-core/memory-bank/bolts/bolt-webview-lit-migration-5/test-walkthrough.md +121 -0
  358. package/src/iris_bundle/frameworks/iris-core/memory-bank/bolts/bolt-welcome-view-1/bolt.md +92 -0
  359. package/src/iris_bundle/frameworks/iris-core/memory-bank/bolts/bolt-welcome-view-1/implementation-plan.md +73 -0
  360. package/src/iris_bundle/frameworks/iris-core/memory-bank/bolts/bolt-welcome-view-1/implementation-walkthrough.md +44 -0
  361. package/src/iris_bundle/frameworks/iris-core/memory-bank/bolts/bolt-welcome-view-1/test-walkthrough.md +49 -0
  362. package/src/iris_bundle/frameworks/iris-core/memory-bank/glossary.md +197 -0
  363. package/src/iris_bundle/frameworks/iris-core/memory-bank/intents/001-multi-agent-orchestration/requirements.md +129 -0
  364. package/src/iris_bundle/frameworks/iris-core/memory-bank/intents/001-multi-agent-orchestration/research/approval-gates-simplification.md +839 -0
  365. package/src/iris_bundle/frameworks/iris-core/memory-bank/intents/001-multi-agent-orchestration/research/archive/approval-gates-analysis.md +331 -0
  366. package/src/iris_bundle/frameworks/iris-core/memory-bank/intents/001-multi-agent-orchestration/system-context.md +167 -0
  367. package/src/iris_bundle/frameworks/iris-core/memory-bank/intents/001-multi-agent-orchestration/units/construction-agent/unit-brief.md +111 -0
  368. package/src/iris_bundle/frameworks/iris-core/memory-bank/intents/001-multi-agent-orchestration/units/inception-agent/unit-brief.md +135 -0
  369. package/src/iris_bundle/frameworks/iris-core/memory-bank/intents/001-multi-agent-orchestration/units/master-agent/unit-brief.md +580 -0
  370. package/src/iris_bundle/frameworks/iris-core/memory-bank/intents/001-multi-agent-orchestration/units/operations-agent/unit-brief.md +72 -0
  371. package/src/iris_bundle/frameworks/iris-core/memory-bank/intents/001-multi-agent-orchestration/units.md +168 -0
  372. package/src/iris_bundle/frameworks/iris-core/memory-bank/intents/002-agentic-coding-tool-integration/requirements.md +96 -0
  373. package/src/iris_bundle/frameworks/iris-core/memory-bank/intents/002-agentic-coding-tool-integration/system-context.md +170 -0
  374. package/src/iris_bundle/frameworks/iris-core/memory-bank/intents/002-agentic-coding-tool-integration/units/antigravity-installer/unit-brief.md +156 -0
  375. package/src/iris_bundle/frameworks/iris-core/memory-bank/intents/002-agentic-coding-tool-integration/units/claude-code-installer/unit-brief.md +180 -0
  376. package/src/iris_bundle/frameworks/iris-core/memory-bank/intents/002-agentic-coding-tool-integration/units/cline-installer/unit-brief.md +106 -0
  377. package/src/iris_bundle/frameworks/iris-core/memory-bank/intents/002-agentic-coding-tool-integration/units/codex-installer/unit-brief.md +106 -0
  378. package/src/iris_bundle/frameworks/iris-core/memory-bank/intents/002-agentic-coding-tool-integration/units/copilot-installer/unit-brief.md +139 -0
  379. package/src/iris_bundle/frameworks/iris-core/memory-bank/intents/002-agentic-coding-tool-integration/units/cursor-installer/unit-brief.md +119 -0
  380. package/src/iris_bundle/frameworks/iris-core/memory-bank/intents/002-agentic-coding-tool-integration/units/gemini-installer/unit-brief.md +107 -0
  381. package/src/iris_bundle/frameworks/iris-core/memory-bank/intents/002-agentic-coding-tool-integration/units/installer-core/unit-brief.md +240 -0
  382. package/src/iris_bundle/frameworks/iris-core/memory-bank/intents/002-agentic-coding-tool-integration/units/kilo-installer/unit-brief.md +106 -0
  383. package/src/iris_bundle/frameworks/iris-core/memory-bank/intents/002-agentic-coding-tool-integration/units/kiro-installer/unit-brief.md +108 -0
  384. package/src/iris_bundle/frameworks/iris-core/memory-bank/intents/002-agentic-coding-tool-integration/units/opencode-installer/unit-brief.md +107 -0
  385. package/src/iris_bundle/frameworks/iris-core/memory-bank/intents/002-agentic-coding-tool-integration/units/roo-installer/unit-brief.md +107 -0
  386. package/src/iris_bundle/frameworks/iris-core/memory-bank/intents/002-agentic-coding-tool-integration/units/windsurf-installer/unit-brief.md +128 -0
  387. package/src/iris_bundle/frameworks/iris-core/memory-bank/intents/002-agentic-coding-tool-integration/units.md +188 -0
  388. package/src/iris_bundle/frameworks/iris-core/memory-bank/intents/003-memory-bank-system/requirements.md +196 -0
  389. package/src/iris_bundle/frameworks/iris-core/memory-bank/intents/003-memory-bank-system/system-context.md +181 -0
  390. package/src/iris_bundle/frameworks/iris-core/memory-bank/intents/003-memory-bank-system/units/artifact-storage/unit-brief.md +192 -0
  391. package/src/iris_bundle/frameworks/iris-core/memory-bank/intents/003-memory-bank-system/units/configuration-schema/unit-brief.md +204 -0
  392. package/src/iris_bundle/frameworks/iris-core/memory-bank/intents/003-memory-bank-system/units/context-loader/unit-brief.md +245 -0
  393. package/src/iris_bundle/frameworks/iris-core/memory-bank/intents/003-memory-bank-system/units.md +97 -0
  394. package/src/iris_bundle/frameworks/iris-core/memory-bank/intents/004-standards-system/requirements.md +125 -0
  395. package/src/iris_bundle/frameworks/iris-core/memory-bank/intents/004-standards-system/system-context.md +158 -0
  396. package/src/iris_bundle/frameworks/iris-core/memory-bank/intents/004-standards-system/units/facilitation-guides/unit-brief.md +250 -0
  397. package/src/iris_bundle/frameworks/iris-core/memory-bank/intents/004-standards-system/units/standards-catalog/unit-brief.md +355 -0
  398. package/src/iris_bundle/frameworks/iris-core/memory-bank/intents/004-standards-system/units/standards-templates/unit-brief.md +394 -0
  399. package/src/iris_bundle/frameworks/iris-core/memory-bank/intents/004-standards-system/units.md +110 -0
  400. package/src/iris_bundle/frameworks/iris-core/memory-bank/intents/005-testing-strategy/requirements.md +188 -0
  401. package/src/iris_bundle/frameworks/iris-core/memory-bank/intents/005-testing-strategy/system-context.md +229 -0
  402. package/src/iris_bundle/frameworks/iris-core/memory-bank/intents/005-testing-strategy/units/01-specification-contract-testing/unit-brief.md +197 -0
  403. package/src/iris_bundle/frameworks/iris-core/memory-bank/intents/005-testing-strategy/units/02-cli-installer-testing/unit-brief.md +377 -0
  404. package/src/iris_bundle/frameworks/iris-core/memory-bank/intents/005-testing-strategy/units/03-golden-dataset-management/unit-brief.md +465 -0
  405. package/src/iris_bundle/frameworks/iris-core/memory-bank/intents/005-testing-strategy/units/04-agent-behavior-evaluation/unit-brief.md +459 -0
  406. package/src/iris_bundle/frameworks/iris-core/memory-bank/intents/005-testing-strategy/units/05-cicd-integration/unit-brief.md +587 -0
  407. package/src/iris_bundle/frameworks/iris-core/memory-bank/intents/005-testing-strategy/units.md +332 -0
  408. package/src/iris_bundle/frameworks/iris-core/memory-bank/intents/006-brownfield-support/requirements.md +214 -0
  409. package/src/iris_bundle/frameworks/iris-core/memory-bank/intents/007-installer-analytics/requirements.md +308 -0
  410. package/src/iris_bundle/frameworks/iris-core/memory-bank/intents/007-installer-analytics/system-context.md +335 -0
  411. package/src/iris_bundle/frameworks/iris-core/memory-bank/intents/007-installer-analytics/units/001-analytics-tracker/construction-log.md +52 -0
  412. package/src/iris_bundle/frameworks/iris-core/memory-bank/intents/007-installer-analytics/units/001-analytics-tracker/stories/001-initialize-mixpanel.md +56 -0
  413. package/src/iris_bundle/frameworks/iris-core/memory-bank/intents/007-installer-analytics/units/001-analytics-tracker/stories/002-detect-shell.md +68 -0
  414. package/src/iris_bundle/frameworks/iris-core/memory-bank/intents/007-installer-analytics/units/001-analytics-tracker/stories/003-check-telemetry-disabled.md +66 -0
  415. package/src/iris_bundle/frameworks/iris-core/memory-bank/intents/007-installer-analytics/units/001-analytics-tracker/stories/004-track-installer-events.md +67 -0
  416. package/src/iris_bundle/frameworks/iris-core/memory-bank/intents/007-installer-analytics/units/001-analytics-tracker/stories/005-track-selection-events.md +66 -0
  417. package/src/iris_bundle/frameworks/iris-core/memory-bank/intents/007-installer-analytics/units/001-analytics-tracker/stories/006-cli-no-telemetry-flag.md +59 -0
  418. package/src/iris_bundle/frameworks/iris-core/memory-bank/intents/007-installer-analytics/units/001-analytics-tracker/unit-brief.md +191 -0
  419. package/src/iris_bundle/frameworks/iris-core/memory-bank/intents/007-installer-analytics/units/002-privacy-documentation/stories/001-create-privacy-md.md +58 -0
  420. package/src/iris_bundle/frameworks/iris-core/memory-bank/intents/007-installer-analytics/units/002-privacy-documentation/stories/002-add-readme-section.md +61 -0
  421. package/src/iris_bundle/frameworks/iris-core/memory-bank/intents/007-installer-analytics/units/002-privacy-documentation/unit-brief.md +158 -0
  422. package/src/iris_bundle/frameworks/iris-core/memory-bank/intents/007-installer-analytics/units.md +453 -0
  423. package/src/iris_bundle/frameworks/iris-core/memory-bank/intents/008-terminal-dashboard/requirements.md +222 -0
  424. package/src/iris_bundle/frameworks/iris-core/memory-bank/intents/008-terminal-dashboard/system-context.md +198 -0
  425. package/src/iris_bundle/frameworks/iris-core/memory-bank/intents/008-terminal-dashboard/units.md +275 -0
  426. package/src/iris_bundle/frameworks/iris-core/memory-bank/intents/009-versioning-strategy/requirements.md +308 -0
  427. package/src/iris_bundle/frameworks/iris-core/memory-bank/intents/009-versioning-strategy/system-context.md +273 -0
  428. package/src/iris_bundle/frameworks/iris-core/memory-bank/intents/009-versioning-strategy/units.md +312 -0
  429. package/src/iris_bundle/frameworks/iris-core/memory-bank/intents/010-smart-unit-decomposition/requirements.md +111 -0
  430. package/src/iris_bundle/frameworks/iris-core/memory-bank/intents/010-smart-unit-decomposition/system-context.md +154 -0
  431. package/src/iris_bundle/frameworks/iris-core/memory-bank/intents/010-smart-unit-decomposition/units.md +102 -0
  432. package/src/iris_bundle/frameworks/iris-core/memory-bank/intents/011-vscode-extension/inception-log.md +101 -0
  433. package/src/iris_bundle/frameworks/iris-core/memory-bank/intents/011-vscode-extension/requirements.md +282 -0
  434. package/src/iris_bundle/frameworks/iris-core/memory-bank/intents/011-vscode-extension/system-context.md +114 -0
  435. package/src/iris_bundle/frameworks/iris-core/memory-bank/intents/011-vscode-extension/units/artifact-parser/construction-log.md +57 -0
  436. package/src/iris_bundle/frameworks/iris-core/memory-bank/intents/011-vscode-extension/units/artifact-parser/stories/001-memory-bank-schema.md +56 -0
  437. package/src/iris_bundle/frameworks/iris-core/memory-bank/intents/011-vscode-extension/units/artifact-parser/stories/002-project-detection.md +54 -0
  438. package/src/iris_bundle/frameworks/iris-core/memory-bank/intents/011-vscode-extension/units/artifact-parser/stories/003-artifact-parsing.md +57 -0
  439. package/src/iris_bundle/frameworks/iris-core/memory-bank/intents/011-vscode-extension/units/artifact-parser/stories/004-frontmatter-parser.md +61 -0
  440. package/src/iris_bundle/frameworks/iris-core/memory-bank/intents/011-vscode-extension/units/artifact-parser/stories/005-bolt-dependencies.md +58 -0
  441. package/src/iris_bundle/frameworks/iris-core/memory-bank/intents/011-vscode-extension/units/artifact-parser/stories/006-activity-feed-derivation.md +70 -0
  442. package/src/iris_bundle/frameworks/iris-core/memory-bank/intents/011-vscode-extension/units/artifact-parser/unit-brief.md +223 -0
  443. package/src/iris_bundle/frameworks/iris-core/memory-bank/intents/011-vscode-extension/units/extension-core/construction-log.md +59 -0
  444. package/src/iris_bundle/frameworks/iris-core/memory-bank/intents/011-vscode-extension/units/extension-core/stories/001-extension-activation.md +55 -0
  445. package/src/iris_bundle/frameworks/iris-core/memory-bank/intents/011-vscode-extension/units/extension-core/stories/002-command-registration.md +54 -0
  446. package/src/iris_bundle/frameworks/iris-core/memory-bank/intents/011-vscode-extension/units/extension-core/stories/003-file-operation-commands.md +57 -0
  447. package/src/iris_bundle/frameworks/iris-core/memory-bank/intents/011-vscode-extension/units/extension-core/unit-brief.md +224 -0
  448. package/src/iris_bundle/frameworks/iris-core/memory-bank/intents/011-vscode-extension/units/file-watcher/construction-log.md +52 -0
  449. package/src/iris_bundle/frameworks/iris-core/memory-bank/intents/011-vscode-extension/units/file-watcher/stories/001-file-system-watcher.md +57 -0
  450. package/src/iris_bundle/frameworks/iris-core/memory-bank/intents/011-vscode-extension/units/file-watcher/stories/002-debounced-refresh.md +53 -0
  451. package/src/iris_bundle/frameworks/iris-core/memory-bank/intents/011-vscode-extension/units/file-watcher/unit-brief.md +173 -0
  452. package/src/iris_bundle/frameworks/iris-core/memory-bank/intents/011-vscode-extension/units/sidebar-provider/construction-log.md +63 -0
  453. package/src/iris_bundle/frameworks/iris-core/memory-bank/intents/011-vscode-extension/units/sidebar-provider/stories/001-tree-data-provider.md +55 -0
  454. package/src/iris_bundle/frameworks/iris-core/memory-bank/intents/011-vscode-extension/units/sidebar-provider/stories/002-intent-unit-story-tree.md +56 -0
  455. package/src/iris_bundle/frameworks/iris-core/memory-bank/intents/011-vscode-extension/units/sidebar-provider/stories/003-bolt-tree.md +56 -0
  456. package/src/iris_bundle/frameworks/iris-core/memory-bank/intents/011-vscode-extension/units/sidebar-provider/stories/004-status-icons.md +55 -0
  457. package/src/iris_bundle/frameworks/iris-core/memory-bank/intents/011-vscode-extension/units/sidebar-provider/stories/005-pixel-logo-footer.md +55 -0
  458. package/src/iris_bundle/frameworks/iris-core/memory-bank/intents/011-vscode-extension/units/sidebar-provider/stories/006-webview-tab-architecture.md +62 -0
  459. package/src/iris_bundle/frameworks/iris-core/memory-bank/intents/011-vscode-extension/units/sidebar-provider/stories/007-command-center-bolts-tab.md +65 -0
  460. package/src/iris_bundle/frameworks/iris-core/memory-bank/intents/011-vscode-extension/units/sidebar-provider/stories/008-current-focus-card.md +62 -0
  461. package/src/iris_bundle/frameworks/iris-core/memory-bank/intents/011-vscode-extension/units/sidebar-provider/stories/009-up-next-queue.md +61 -0
  462. package/src/iris_bundle/frameworks/iris-core/memory-bank/intents/011-vscode-extension/units/sidebar-provider/stories/010-activity-feed-ui.md +63 -0
  463. package/src/iris_bundle/frameworks/iris-core/memory-bank/intents/011-vscode-extension/units/sidebar-provider/stories/011-filewatcher-statestore-integration.md +49 -0
  464. package/src/iris_bundle/frameworks/iris-core/memory-bank/intents/011-vscode-extension/units/sidebar-provider/stories/012-next-actions-ui.md +57 -0
  465. package/src/iris_bundle/frameworks/iris-core/memory-bank/intents/011-vscode-extension/units/sidebar-provider/stories/013-start-bolt-action.md +72 -0
  466. package/src/iris_bundle/frameworks/iris-core/memory-bank/intents/011-vscode-extension/units/sidebar-provider/stories/014-intent-selection-strategies.md +54 -0
  467. package/src/iris_bundle/frameworks/iris-core/memory-bank/intents/011-vscode-extension/units/sidebar-provider/stories/015-persist-expanded-state.md +56 -0
  468. package/src/iris_bundle/frameworks/iris-core/memory-bank/intents/011-vscode-extension/units/sidebar-provider/stories/016-bolt-filtering.md +72 -0
  469. package/src/iris_bundle/frameworks/iris-core/memory-bank/intents/011-vscode-extension/units/sidebar-provider/stories/017-activity-open-button.md +50 -0
  470. package/src/iris_bundle/frameworks/iris-core/memory-bank/intents/011-vscode-extension/units/sidebar-provider/stories/018-specs-view.md +63 -0
  471. package/src/iris_bundle/frameworks/iris-core/memory-bank/intents/011-vscode-extension/units/sidebar-provider/stories/019-overview-view.md +84 -0
  472. package/src/iris_bundle/frameworks/iris-core/memory-bank/intents/011-vscode-extension/units/sidebar-provider/unit-brief.md +305 -0
  473. package/src/iris_bundle/frameworks/iris-core/memory-bank/intents/011-vscode-extension/units/webview-lit-migration/stories/020-fix-infinite-rerender.md +144 -0
  474. package/src/iris_bundle/frameworks/iris-core/memory-bank/intents/011-vscode-extension/units/webview-lit-migration/stories/021-remove-duplicate-files.md +94 -0
  475. package/src/iris_bundle/frameworks/iris-core/memory-bank/intents/011-vscode-extension/units/webview-lit-migration/stories/022-setup-esbuild.md +156 -0
  476. package/src/iris_bundle/frameworks/iris-core/memory-bank/intents/011-vscode-extension/units/webview-lit-migration/stories/023-lit-scaffold.md +202 -0
  477. package/src/iris_bundle/frameworks/iris-core/memory-bank/intents/011-vscode-extension/units/webview-lit-migration/stories/024-tabs-component.md +161 -0
  478. package/src/iris_bundle/frameworks/iris-core/memory-bank/intents/011-vscode-extension/units/webview-lit-migration/stories/025-bolts-view-components.md +182 -0
  479. package/src/iris_bundle/frameworks/iris-core/memory-bank/intents/011-vscode-extension/units/webview-lit-migration/stories/026-specs-view-components.md +223 -0
  480. package/src/iris_bundle/frameworks/iris-core/memory-bank/intents/011-vscode-extension/units/webview-lit-migration/stories/027-overview-view-components.md +391 -0
  481. package/src/iris_bundle/frameworks/iris-core/memory-bank/intents/011-vscode-extension/units/webview-lit-migration/stories/028-state-context.md +317 -0
  482. package/src/iris_bundle/frameworks/iris-core/memory-bank/intents/011-vscode-extension/units/webview-lit-migration/stories/029-ipc-typed-messaging.md +396 -0
  483. package/src/iris_bundle/frameworks/iris-core/memory-bank/intents/011-vscode-extension/units/webview-lit-migration/unit-brief.md +133 -0
  484. package/src/iris_bundle/frameworks/iris-core/memory-bank/intents/011-vscode-extension/units/welcome-view/construction-log.md +58 -0
  485. package/src/iris_bundle/frameworks/iris-core/memory-bank/intents/011-vscode-extension/units/welcome-view/stories/001-welcome-view-ui.md +57 -0
  486. package/src/iris_bundle/frameworks/iris-core/memory-bank/intents/011-vscode-extension/units/welcome-view/stories/002-install-button-flow.md +55 -0
  487. package/src/iris_bundle/frameworks/iris-core/memory-bank/intents/011-vscode-extension/units/welcome-view/stories/003-post-installation-detection.md +55 -0
  488. package/src/iris_bundle/frameworks/iris-core/memory-bank/intents/011-vscode-extension/units/welcome-view/unit-brief.md +211 -0
  489. package/src/iris_bundle/frameworks/iris-core/memory-bank/intents/011-vscode-extension/units.md +129 -0
  490. package/src/iris_bundle/frameworks/iris-core/memory-bank/maintenance-log.md +21 -0
  491. package/src/iris_bundle/frameworks/iris-core/memory-bank/project.yaml +16 -0
  492. package/src/iris_bundle/frameworks/iris-core/memory-bank/research/test_strategy/promptfoo-specsmd-tutorial.md +911 -0
  493. package/src/iris_bundle/frameworks/iris-core/memory-bank/research/test_strategy/promptfoo-tutorial.md +796 -0
  494. package/src/iris_bundle/frameworks/iris-core/memory-bank/research/test_strategy/testing-strategy.md +1057 -0
  495. package/src/iris_bundle/frameworks/iris-core/memory-bank/research/unified-modernization-model.md +559 -0
  496. package/src/iris_bundle/frameworks/iris-core/memory-bank/research/vibe-to-production-academic-research.md +578 -0
  497. package/src/iris_bundle/frameworks/iris-core/memory-bank/research/vibe-to-spec-flow-options.md +547 -0
  498. package/src/iris_bundle/frameworks/iris-core/memory-bank/standards/coding-standards.md +217 -0
  499. package/src/iris_bundle/frameworks/iris-core/memory-bank/standards/output-formatting.md +202 -0
  500. package/src/iris_bundle/frameworks/iris-core/memory-bank/standards/skill-template.md +308 -0
  501. package/src/iris_bundle/frameworks/iris-core/memory-bank/standards/system-architecture.md +177 -0
  502. package/src/iris_bundle/frameworks/iris-core/memory-bank/standards/tech-stack.md +88 -0
  503. package/src/iris_bundle/frameworks/iris-core/memory-bank/story-index.md +154 -0
  504. package/src/iris_bundle/frameworks/iris-core/memory-bank/term-mappings.md +121 -0
  505. package/src/iris_bundle/frameworks/iris-core/pack.yaml +2 -0
  506. package/src/iris_bundle/frameworks/iris-core/package.json +11 -0
  507. package/src/iris_bundle/frameworks/iris-core/policy.yaml +73 -0
  508. package/src/iris_bundle/frameworks/iris-core/resources/ai-dlc-specification.md +286 -0
  509. package/src/iris_bundle/frameworks/iris-core/resources/aidlc.pdf +0 -0
  510. package/src/iris_bundle/frameworks/iris-core/resources/images/aidlc-core-framework.png +0 -0
  511. package/src/iris_bundle/frameworks/iris-core/resources/images/aidlc-phases-detail.png +0 -0
  512. package/src/iris_bundle/frameworks/iris-core/resources/images/aidlc-workflow-steps.png +0 -0
  513. package/src/iris_bundle/frameworks/iris-core/routes.yaml +98 -0
  514. package/src/iris_bundle/frameworks/iris-core/src/README.md +322 -0
  515. package/src/iris_bundle/frameworks/iris-core/src/__tests__/schemas/agent.schema.yaml +20 -0
  516. package/src/iris_bundle/frameworks/iris-core/src/__tests__/schemas/catalog.schema.yaml +60 -0
  517. package/src/iris_bundle/frameworks/iris-core/src/__tests__/schemas/context-config.schema.yaml +24 -0
  518. package/src/iris_bundle/frameworks/iris-core/src/__tests__/schemas/memory-bank.schema.yaml +61 -0
  519. package/src/iris_bundle/frameworks/iris-core/src/__tests__/schemas/skill.schema.yaml +22 -0
  520. package/src/iris_bundle/frameworks/iris-core/src/__tests__/unit/analytics/analytics.test.ts +240 -0
  521. package/src/iris_bundle/frameworks/iris-core/src/__tests__/unit/architecture/bolt-type-agnostic.test.ts +282 -0
  522. package/src/iris_bundle/frameworks/iris-core/src/__tests__/unit/flow-consistency/code-examples.test.ts +93 -0
  523. package/src/iris_bundle/frameworks/iris-core/src/__tests__/unit/flow-consistency/helpers.ts +79 -0
  524. package/src/iris_bundle/frameworks/iris-core/src/__tests__/unit/flow-consistency/placeholder-consistency.test.ts +76 -0
  525. package/src/iris_bundle/frameworks/iris-core/src/__tests__/unit/flow-consistency/reference-integrity.test.ts +92 -0
  526. package/src/iris_bundle/frameworks/iris-core/src/__tests__/unit/flow-consistency/terminology-consistency.test.ts +72 -0
  527. package/src/iris_bundle/frameworks/iris-core/src/__tests__/unit/schema-validation/markdown-schema.test.ts +55 -0
  528. package/src/iris_bundle/frameworks/iris-core/src/__tests__/unit/schema-validation/yaml-config-schema.test.ts +53 -0
  529. package/src/iris_bundle/frameworks/iris-core/src/bin/cli.js +21 -0
  530. package/src/iris_bundle/frameworks/iris-core/src/flows/aidlc/README.md +372 -0
  531. package/src/iris_bundle/frameworks/iris-core/src/flows/aidlc/agents/construction-agent.md +80 -0
  532. package/src/iris_bundle/frameworks/iris-core/src/flows/aidlc/agents/inception-agent.md +97 -0
  533. package/src/iris_bundle/frameworks/iris-core/src/flows/aidlc/agents/master-agent.md +61 -0
  534. package/src/iris_bundle/frameworks/iris-core/src/flows/aidlc/agents/operations-agent.md +89 -0
  535. package/src/iris_bundle/frameworks/iris-core/src/flows/aidlc/commands/construction-agent.md +63 -0
  536. package/src/iris_bundle/frameworks/iris-core/src/flows/aidlc/commands/inception-agent.md +55 -0
  537. package/src/iris_bundle/frameworks/iris-core/src/flows/aidlc/commands/master-agent.md +47 -0
  538. package/src/iris_bundle/frameworks/iris-core/src/flows/aidlc/commands/operations-agent.md +77 -0
  539. package/src/iris_bundle/frameworks/iris-core/src/flows/aidlc/context-config.yaml +67 -0
  540. package/src/iris_bundle/frameworks/iris-core/src/flows/aidlc/memory-bank.yaml +104 -0
  541. package/src/iris_bundle/frameworks/iris-core/src/flows/aidlc/quick-start.md +322 -0
  542. package/src/iris_bundle/frameworks/iris-core/src/flows/aidlc/skills/construction/bolt-list.md +163 -0
  543. package/src/iris_bundle/frameworks/iris-core/src/flows/aidlc/skills/construction/bolt-replan.md +345 -0
  544. package/src/iris_bundle/frameworks/iris-core/src/flows/aidlc/skills/construction/bolt-start.md +442 -0
  545. package/src/iris_bundle/frameworks/iris-core/src/flows/aidlc/skills/construction/bolt-status.md +185 -0
  546. package/src/iris_bundle/frameworks/iris-core/src/flows/aidlc/skills/construction/navigator.md +196 -0
  547. package/src/iris_bundle/frameworks/iris-core/src/flows/aidlc/skills/inception/bolt-plan.md +372 -0
  548. package/src/iris_bundle/frameworks/iris-core/src/flows/aidlc/skills/inception/context.md +171 -0
  549. package/src/iris_bundle/frameworks/iris-core/src/flows/aidlc/skills/inception/intent-create.md +211 -0
  550. package/src/iris_bundle/frameworks/iris-core/src/flows/aidlc/skills/inception/intent-list.md +124 -0
  551. package/src/iris_bundle/frameworks/iris-core/src/flows/aidlc/skills/inception/navigator.md +207 -0
  552. package/src/iris_bundle/frameworks/iris-core/src/flows/aidlc/skills/inception/requirements.md +227 -0
  553. package/src/iris_bundle/frameworks/iris-core/src/flows/aidlc/skills/inception/review.md +248 -0
  554. package/src/iris_bundle/frameworks/iris-core/src/flows/aidlc/skills/inception/story-create.md +304 -0
  555. package/src/iris_bundle/frameworks/iris-core/src/flows/aidlc/skills/inception/units.md +278 -0
  556. package/src/iris_bundle/frameworks/iris-core/src/flows/aidlc/skills/master/analyze-context.md +239 -0
  557. package/src/iris_bundle/frameworks/iris-core/src/flows/aidlc/skills/master/answer-question.md +141 -0
  558. package/src/iris_bundle/frameworks/iris-core/src/flows/aidlc/skills/master/explain-flow.md +158 -0
  559. package/src/iris_bundle/frameworks/iris-core/src/flows/aidlc/skills/master/project-init.md +281 -0
  560. package/src/iris_bundle/frameworks/iris-core/src/flows/aidlc/skills/master/route-request.md +126 -0
  561. package/src/iris_bundle/frameworks/iris-core/src/flows/aidlc/skills/operations/build.md +237 -0
  562. package/src/iris_bundle/frameworks/iris-core/src/flows/aidlc/skills/operations/deploy.md +259 -0
  563. package/src/iris_bundle/frameworks/iris-core/src/flows/aidlc/skills/operations/monitor.md +265 -0
  564. package/src/iris_bundle/frameworks/iris-core/src/flows/aidlc/skills/operations/navigator.md +209 -0
  565. package/src/iris_bundle/frameworks/iris-core/src/flows/aidlc/skills/operations/verify.md +224 -0
  566. package/src/iris_bundle/frameworks/iris-core/src/flows/aidlc/templates/construction/bolt-template.md +226 -0
  567. package/src/iris_bundle/frameworks/iris-core/src/flows/aidlc/templates/construction/bolt-types/ddd-construction-bolt/adr-template.md +49 -0
  568. package/src/iris_bundle/frameworks/iris-core/src/flows/aidlc/templates/construction/bolt-types/ddd-construction-bolt/ddd-01-domain-model-template.md +55 -0
  569. package/src/iris_bundle/frameworks/iris-core/src/flows/aidlc/templates/construction/bolt-types/ddd-construction-bolt/ddd-02-technical-design-template.md +67 -0
  570. package/src/iris_bundle/frameworks/iris-core/src/flows/aidlc/templates/construction/bolt-types/ddd-construction-bolt/ddd-03-test-report-template.md +62 -0
  571. package/src/iris_bundle/frameworks/iris-core/src/flows/aidlc/templates/construction/bolt-types/ddd-construction-bolt.md +528 -0
  572. package/src/iris_bundle/frameworks/iris-core/src/flows/aidlc/templates/construction/bolt-types/simple-construction-bolt.md +347 -0
  573. package/src/iris_bundle/frameworks/iris-core/src/flows/aidlc/templates/construction/bolt-types/spike-bolt.md +240 -0
  574. package/src/iris_bundle/frameworks/iris-core/src/flows/aidlc/templates/construction/construction-log-template.md +129 -0
  575. package/src/iris_bundle/frameworks/iris-core/src/flows/aidlc/templates/construction/standards/coding-standards.md +29 -0
  576. package/src/iris_bundle/frameworks/iris-core/src/flows/aidlc/templates/construction/standards/system-architecture.md +22 -0
  577. package/src/iris_bundle/frameworks/iris-core/src/flows/aidlc/templates/construction/standards/tech-stack.md +19 -0
  578. package/src/iris_bundle/frameworks/iris-core/src/flows/aidlc/templates/inception/inception-log-template.md +134 -0
  579. package/src/iris_bundle/frameworks/iris-core/src/flows/aidlc/templates/inception/project/README.md +55 -0
  580. package/src/iris_bundle/frameworks/iris-core/src/flows/aidlc/templates/inception/requirements-template.md +144 -0
  581. package/src/iris_bundle/frameworks/iris-core/src/flows/aidlc/templates/inception/stories-template.md +38 -0
  582. package/src/iris_bundle/frameworks/iris-core/src/flows/aidlc/templates/inception/story-template.md +147 -0
  583. package/src/iris_bundle/frameworks/iris-core/src/flows/aidlc/templates/inception/system-context-template.md +29 -0
  584. package/src/iris_bundle/frameworks/iris-core/src/flows/aidlc/templates/inception/unit-brief-template.md +177 -0
  585. package/src/iris_bundle/frameworks/iris-core/src/flows/aidlc/templates/inception/units-template.md +52 -0
  586. package/src/iris_bundle/frameworks/iris-core/src/flows/aidlc/templates/standards/catalog.yaml +345 -0
  587. package/src/iris_bundle/frameworks/iris-core/src/flows/aidlc/templates/standards/coding-standards.guide.md +553 -0
  588. package/src/iris_bundle/frameworks/iris-core/src/flows/aidlc/templates/standards/data-stack.guide.md +162 -0
  589. package/src/iris_bundle/frameworks/iris-core/src/flows/aidlc/templates/standards/tech-stack.guide.md +280 -0
  590. package/src/iris_bundle/frameworks/iris-core/src/lib/InstallerFactory.js +36 -0
  591. package/src/iris_bundle/frameworks/iris-core/src/lib/analytics/env-detector.js +92 -0
  592. package/src/iris_bundle/frameworks/iris-core/src/lib/analytics/index.js +22 -0
  593. package/src/iris_bundle/frameworks/iris-core/src/lib/analytics/machine-id.js +33 -0
  594. package/src/iris_bundle/frameworks/iris-core/src/lib/analytics/tracker.js +232 -0
  595. package/src/iris_bundle/frameworks/iris-core/src/lib/cli-utils.js +342 -0
  596. package/src/iris_bundle/frameworks/iris-core/src/lib/constants.js +32 -0
  597. package/src/iris_bundle/frameworks/iris-core/src/lib/installer.js +402 -0
  598. package/src/iris_bundle/frameworks/iris-core/src/lib/installers/AntigravityInstaller.js +22 -0
  599. package/src/iris_bundle/frameworks/iris-core/src/lib/installers/ClaudeInstaller.js +85 -0
  600. package/src/iris_bundle/frameworks/iris-core/src/lib/installers/ClineInstaller.js +21 -0
  601. package/src/iris_bundle/frameworks/iris-core/src/lib/installers/CodexInstaller.js +21 -0
  602. package/src/iris_bundle/frameworks/iris-core/src/lib/installers/CopilotInstaller.js +113 -0
  603. package/src/iris_bundle/frameworks/iris-core/src/lib/installers/CursorInstaller.js +63 -0
  604. package/src/iris_bundle/frameworks/iris-core/src/lib/installers/GeminiInstaller.js +75 -0
  605. package/src/iris_bundle/frameworks/iris-core/src/lib/installers/KiroInstaller.js +22 -0
  606. package/src/iris_bundle/frameworks/iris-core/src/lib/installers/OpenCodeInstaller.js +22 -0
  607. package/src/iris_bundle/frameworks/iris-core/src/lib/installers/RooInstaller.js +22 -0
  608. package/src/iris_bundle/frameworks/iris-core/src/lib/installers/ToolInstaller.js +73 -0
  609. package/src/iris_bundle/frameworks/iris-core/src/lib/installers/WindsurfInstaller.js +76 -0
  610. package/src/iris_bundle/frameworks/iris-core/src/lib/markdown-validator.ts +175 -0
  611. package/src/iris_bundle/frameworks/iris-core/src/lib/yaml-validator.ts +99 -0
  612. package/src/iris_bundle/frameworks/iris-core/src/package-lock.json +9922 -0
  613. package/src/iris_bundle/frameworks/iris-core/src/package.json +118 -0
  614. package/src/iris_bundle/frameworks/iris-core/src/scripts/artifact-validator.js +594 -0
  615. package/src/iris_bundle/frameworks/iris-core/src/scripts/bolt-complete.js +606 -0
  616. package/src/iris_bundle/frameworks/iris-core/src/scripts/status-integrity.js +598 -0
  617. package/src/iris_bundle/frameworks/iris-core/src/specs_md_pixel_logo.png +0 -0
  618. package/src/iris_bundle/frameworks/iris-core/src/tsconfig.json +16 -0
  619. package/src/iris_bundle/frameworks/iris-core/src/vitest.config.ts +12 -0
  620. package/src/iris_bundle/frameworks/iris-core/vs-code-extension/.claude/skills/frontend-design/SKILL.md +42 -0
  621. package/src/iris_bundle/frameworks/iris-core/vs-code-extension/.mocharc.json +5 -0
  622. package/src/iris_bundle/frameworks/iris-core/vs-code-extension/.vscodeignore +17 -0
  623. package/src/iris_bundle/frameworks/iris-core/vs-code-extension/DEVGUIDE.md +103 -0
  624. package/src/iris_bundle/frameworks/iris-core/vs-code-extension/LICENSE +21 -0
  625. package/src/iris_bundle/frameworks/iris-core/vs-code-extension/README.md +198 -0
  626. package/src/iris_bundle/frameworks/iris-core/vs-code-extension/design-mockups/index.html +635 -0
  627. package/src/iris_bundle/frameworks/iris-core/vs-code-extension/design-mockups/variation-1-metrics-dashboard.html +542 -0
  628. package/src/iris_bundle/frameworks/iris-core/vs-code-extension/design-mockups/variation-10-dual-view-focus.html +1105 -0
  629. package/src/iris_bundle/frameworks/iris-core/vs-code-extension/design-mockups/variation-11-dual-view-grouped.html +2304 -0
  630. package/src/iris_bundle/frameworks/iris-core/vs-code-extension/design-mockups/variation-12-dependency-graph.html +1400 -0
  631. package/src/iris_bundle/frameworks/iris-core/vs-code-extension/design-mockups/variation-13-hierarchy-explorer.html +1278 -0
  632. package/src/iris_bundle/frameworks/iris-core/vs-code-extension/design-mockups/variation-14-swimlane-deps.html +1370 -0
  633. package/src/iris_bundle/frameworks/iris-core/vs-code-extension/design-mockups/variation-2-pipeline-flow.html +673 -0
  634. package/src/iris_bundle/frameworks/iris-core/vs-code-extension/design-mockups/variation-3-focus-mode.html +898 -0
  635. package/src/iris_bundle/frameworks/iris-core/vs-code-extension/design-mockups/variation-4-kanban-board.html +858 -0
  636. package/src/iris_bundle/frameworks/iris-core/vs-code-extension/design-mockups/variation-5-timeline.html +890 -0
  637. package/src/iris_bundle/frameworks/iris-core/vs-code-extension/design-mockups/variation-6-activity-feed.html +923 -0
  638. package/src/iris_bundle/frameworks/iris-core/vs-code-extension/design-mockups/variation-7-heatmap-grid.html +932 -0
  639. package/src/iris_bundle/frameworks/iris-core/vs-code-extension/design-mockups/variation-8-2-spec.md +657 -0
  640. package/src/iris_bundle/frameworks/iris-core/vs-code-extension/design-mockups/variation-8-2.html +2098 -0
  641. package/src/iris_bundle/frameworks/iris-core/vs-code-extension/design-mockups/variation-8-command-center.html +2043 -0
  642. package/src/iris_bundle/frameworks/iris-core/vs-code-extension/design-mockups/variation-8a-command-center-timeline.html +1222 -0
  643. package/src/iris_bundle/frameworks/iris-core/vs-code-extension/design-mockups/variation-9-dual-view.html +1101 -0
  644. package/src/iris_bundle/frameworks/iris-core/vs-code-extension/esbuild.webview.mjs +70 -0
  645. package/src/iris_bundle/frameworks/iris-core/vs-code-extension/eslint.config.mjs +36 -0
  646. package/src/iris_bundle/frameworks/iris-core/vs-code-extension/package-lock.json +5712 -0
  647. package/src/iris_bundle/frameworks/iris-core/vs-code-extension/package.json +116 -0
  648. package/src/iris_bundle/frameworks/iris-core/vs-code-extension/resources/extension-preview.png +0 -0
  649. package/src/iris_bundle/frameworks/iris-core/vs-code-extension/resources/extension_icon.svg +40 -0
  650. package/src/iris_bundle/frameworks/iris-core/vs-code-extension/resources/favicon-64.png +0 -0
  651. package/src/iris_bundle/frameworks/iris-core/vs-code-extension/resources/favicon.png +0 -0
  652. package/src/iris_bundle/frameworks/iris-core/vs-code-extension/resources/favicon.svg +40 -0
  653. package/src/iris_bundle/frameworks/iris-core/vs-code-extension/resources/logo.png +0 -0
  654. package/src/iris_bundle/frameworks/iris-core/vs-code-extension/src/extension.ts +142 -0
  655. package/src/iris_bundle/frameworks/iris-core/vs-code-extension/src/parser/activityFeed.ts +184 -0
  656. package/src/iris_bundle/frameworks/iris-core/vs-code-extension/src/parser/artifactParser.ts +477 -0
  657. package/src/iris_bundle/frameworks/iris-core/vs-code-extension/src/parser/boltTypeParser.ts +191 -0
  658. package/src/iris_bundle/frameworks/iris-core/vs-code-extension/src/parser/dependencyComputation.ts +157 -0
  659. package/src/iris_bundle/frameworks/iris-core/vs-code-extension/src/parser/frontmatterParser.ts +144 -0
  660. package/src/iris_bundle/frameworks/iris-core/vs-code-extension/src/parser/index.ts +93 -0
  661. package/src/iris_bundle/frameworks/iris-core/vs-code-extension/src/parser/memoryBankSchema.ts +140 -0
  662. package/src/iris_bundle/frameworks/iris-core/vs-code-extension/src/parser/projectDetection.ts +132 -0
  663. package/src/iris_bundle/frameworks/iris-core/vs-code-extension/src/parser/types.ts +241 -0
  664. package/src/iris_bundle/frameworks/iris-core/vs-code-extension/src/sidebar/iconHelper.ts +82 -0
  665. package/src/iris_bundle/frameworks/iris-core/vs-code-extension/src/sidebar/index.ts +85 -0
  666. package/src/iris_bundle/frameworks/iris-core/vs-code-extension/src/sidebar/treeBuilder.ts +289 -0
  667. package/src/iris_bundle/frameworks/iris-core/vs-code-extension/src/sidebar/treeProvider.ts +225 -0
  668. package/src/iris_bundle/frameworks/iris-core/vs-code-extension/src/sidebar/types.ts +254 -0
  669. package/src/iris_bundle/frameworks/iris-core/vs-code-extension/src/sidebar/webviewMessaging.ts +306 -0
  670. package/src/iris_bundle/frameworks/iris-core/vs-code-extension/src/sidebar/webviewProvider.ts +866 -0
  671. package/src/iris_bundle/frameworks/iris-core/vs-code-extension/src/state/index.ts +114 -0
  672. package/src/iris_bundle/frameworks/iris-core/vs-code-extension/src/state/selectors.ts +652 -0
  673. package/src/iris_bundle/frameworks/iris-core/vs-code-extension/src/state/stateStore.ts +419 -0
  674. package/src/iris_bundle/frameworks/iris-core/vs-code-extension/src/state/types.ts +311 -0
  675. package/src/iris_bundle/frameworks/iris-core/vs-code-extension/src/test/parser/activityFeed.test.ts +269 -0
  676. package/src/iris_bundle/frameworks/iris-core/vs-code-extension/src/test/parser/artifactParser.test.ts +440 -0
  677. package/src/iris_bundle/frameworks/iris-core/vs-code-extension/src/test/parser/dependencyComputation.test.ts +288 -0
  678. package/src/iris_bundle/frameworks/iris-core/vs-code-extension/src/test/parser/frontmatterParser.test.ts +191 -0
  679. package/src/iris_bundle/frameworks/iris-core/vs-code-extension/src/test/parser/memoryBankSchema.test.ts +185 -0
  680. package/src/iris_bundle/frameworks/iris-core/vs-code-extension/src/test/parser/projectDetection.test.ts +146 -0
  681. package/src/iris_bundle/frameworks/iris-core/vs-code-extension/src/test/runTest.ts +20 -0
  682. package/src/iris_bundle/frameworks/iris-core/vs-code-extension/src/test/sidebar/treeBuilder.test.ts +329 -0
  683. package/src/iris_bundle/frameworks/iris-core/vs-code-extension/src/test/sidebar/types.test.ts +239 -0
  684. package/src/iris_bundle/frameworks/iris-core/vs-code-extension/src/test/sidebar/webviewContent.test.ts +67 -0
  685. package/src/iris_bundle/frameworks/iris-core/vs-code-extension/src/test/sidebar/webviewMessaging.test.ts +369 -0
  686. package/src/iris_bundle/frameworks/iris-core/vs-code-extension/src/test/sidebar/webviewProvider.test.ts +282 -0
  687. package/src/iris_bundle/frameworks/iris-core/vs-code-extension/src/test/state/selectors.test.ts +457 -0
  688. package/src/iris_bundle/frameworks/iris-core/vs-code-extension/src/test/state/stateStore.test.ts +622 -0
  689. package/src/iris_bundle/frameworks/iris-core/vs-code-extension/src/test/watcher/debounce.test.ts +155 -0
  690. package/src/iris_bundle/frameworks/iris-core/vs-code-extension/src/test/watcher/fileWatcher.test.ts +77 -0
  691. package/src/iris_bundle/frameworks/iris-core/vs-code-extension/src/watcher/debounce.ts +70 -0
  692. package/src/iris_bundle/frameworks/iris-core/vs-code-extension/src/watcher/fileWatcher.ts +147 -0
  693. package/src/iris_bundle/frameworks/iris-core/vs-code-extension/src/watcher/index.ts +39 -0
  694. package/src/iris_bundle/frameworks/iris-core/vs-code-extension/src/watcher/types.ts +43 -0
  695. package/src/iris_bundle/frameworks/iris-core/vs-code-extension/src/webview/components/app.ts +870 -0
  696. package/src/iris_bundle/frameworks/iris-core/vs-code-extension/src/webview/components/bolts/activity-feed.ts +232 -0
  697. package/src/iris_bundle/frameworks/iris-core/vs-code-extension/src/webview/components/bolts/activity-item.ts +208 -0
  698. package/src/iris_bundle/frameworks/iris-core/vs-code-extension/src/webview/components/bolts/bolts-view.ts +201 -0
  699. package/src/iris_bundle/frameworks/iris-core/vs-code-extension/src/webview/components/bolts/completion-item.ts +299 -0
  700. package/src/iris_bundle/frameworks/iris-core/vs-code-extension/src/webview/components/bolts/completions-section.ts +197 -0
  701. package/src/iris_bundle/frameworks/iris-core/vs-code-extension/src/webview/components/bolts/current-bolts.ts +184 -0
  702. package/src/iris_bundle/frameworks/iris-core/vs-code-extension/src/webview/components/bolts/focus-card.ts +431 -0
  703. package/src/iris_bundle/frameworks/iris-core/vs-code-extension/src/webview/components/bolts/focus-section.ts +179 -0
  704. package/src/iris_bundle/frameworks/iris-core/vs-code-extension/src/webview/components/bolts/queue-item.ts +306 -0
  705. package/src/iris_bundle/frameworks/iris-core/vs-code-extension/src/webview/components/bolts/queue-section.ts +198 -0
  706. package/src/iris_bundle/frameworks/iris-core/vs-code-extension/src/webview/components/bolts/stories-list.ts +151 -0
  707. package/src/iris_bundle/frameworks/iris-core/vs-code-extension/src/webview/components/shared/base-element.ts +29 -0
  708. package/src/iris_bundle/frameworks/iris-core/vs-code-extension/src/webview/components/shared/empty-state.ts +82 -0
  709. package/src/iris_bundle/frameworks/iris-core/vs-code-extension/src/webview/components/shared/progress-bar.ts +120 -0
  710. package/src/iris_bundle/frameworks/iris-core/vs-code-extension/src/webview/components/shared/progress-ring.ts +100 -0
  711. package/src/iris_bundle/frameworks/iris-core/vs-code-extension/src/webview/components/shared/stage-pipeline.ts +133 -0
  712. package/src/iris_bundle/frameworks/iris-core/vs-code-extension/src/webview/components/tabs/view-tabs.ts +127 -0
  713. package/src/iris_bundle/frameworks/iris-core/vs-code-extension/src/webview/html.ts +542 -0
  714. package/src/iris_bundle/frameworks/iris-core/vs-code-extension/src/webview/index.ts +104 -0
  715. package/src/iris_bundle/frameworks/iris-core/vs-code-extension/src/webview/lit/index.ts +16 -0
  716. package/src/iris_bundle/frameworks/iris-core/vs-code-extension/src/webview/scripts.ts +241 -0
  717. package/src/iris_bundle/frameworks/iris-core/vs-code-extension/src/webview/styles/theme.ts +50 -0
  718. package/src/iris_bundle/frameworks/iris-core/vs-code-extension/src/webview/styles.ts +1194 -0
  719. package/src/iris_bundle/frameworks/iris-core/vs-code-extension/src/webview/types/messages.ts +40 -0
  720. package/src/iris_bundle/frameworks/iris-core/vs-code-extension/src/webview/types/vscode.ts +13 -0
  721. package/src/iris_bundle/frameworks/iris-core/vs-code-extension/src/webview/utils/messaging.ts +57 -0
  722. package/src/iris_bundle/frameworks/iris-core/vs-code-extension/src/webview/utils.ts +16 -0
  723. package/src/iris_bundle/frameworks/iris-core/vs-code-extension/src/webview/vscode-api.ts +14 -0
  724. package/src/iris_bundle/frameworks/iris-core/vs-code-extension/src/welcome/WelcomeViewProvider.ts +254 -0
  725. package/src/iris_bundle/frameworks/iris-core/vs-code-extension/src/welcome/index.ts +9 -0
  726. package/src/iris_bundle/frameworks/iris-core/vs-code-extension/src/welcome/installHandler.ts +82 -0
  727. package/src/iris_bundle/frameworks/iris-core/vs-code-extension/tsconfig.json +30 -0
  728. package/src/iris_bundle/frameworks/iris-core/vs-code-extension/tsconfig.test.json +26 -0
  729. package/src/iris_bundle/frameworks/iris-core/vs-code-extension/tsconfig.webview.json +23 -0
@@ -0,0 +1,578 @@
1
+ # Vibe-Coded Prototype to Production: Academic Research Deep Dive
2
+
3
+ > **Research Date**: 2025-12-09
4
+ > **Author**: irismd research
5
+ > **Method**: Sequential Thinking Analysis with Web Search (10 steps)
6
+ > **Focus**: Academic papers, benchmarks, and formal methods for prototype-to-production transformation
7
+
8
+ ---
9
+
10
+ ## Executive Summary
11
+
12
+ This research addresses the core challenge for iris.md: **How to transform vibe-coded prototypes into production-quality software while preserving domain knowledge, without the risk of AI regeneration drift.**
13
+
14
+ ### The Core Problem
15
+
16
+ When converting vibe-coded prototypes to AI-DLC specifications:
17
+
18
+ 1. **Non-determinism Risk**: Studies show 75% variance in LLM code generation outputs
19
+ 2. **Knowledge Preservation**: Tech stack, UX flows, domain objects, and business logic must transfer
20
+ 3. **Regeneration Drift**: Specs regenerated from different models/tools may produce fundamentally different code
21
+ 4. **Brownfield Challenge**: Existing codebases need incremental adoption, not greenfield rewrites
22
+
23
+ ### Key Finding
24
+
25
+ Academic research validates this concern: **"Setting temperature to 0 does not guarantee determinism in code generation"** (Ouyang et al., 2024). The solution requires **anchoring mechanisms** beyond specifications alone.
26
+
27
+ ---
28
+
29
+ ## 5 Recommended Options
30
+
31
+ ### Option 1: Specification-First with Symbolic Anchoring
32
+
33
+ **Approach**: Extract formal specifications from vibe-coded prototypes using LLMs, then use **symbolic execution** to create deterministic behavioral anchors.
34
+
35
+ **Academic Foundation**:
36
+
37
+ - **AutoSpec** (arXiv:2404.00762) achieves 79% automated verification through specification synthesis
38
+ - **Symbolic Clustering** (arXiv:2502.11620) enables precise functional equivalence checking
39
+ - **SpecRover/SpecGen** (arXiv:2408.02232, arXiv:2401.08807) for code intent extraction
40
+
41
+ **How It Works**:
42
+
43
+ ```text
44
+ Vibe-Coded Prototype
45
+ ↓
46
+ [1] LLM extracts specifications (AutoSpec approach)
47
+ ↓
48
+ [2] Symbolic execution generates behavioral traces
49
+ ↓
50
+ [3] Traces become "golden anchors" for regeneration
51
+ ↓
52
+ [4] Any regenerated code must pass symbolic equivalence check
53
+ ↓
54
+ Production Code (verified equivalent)
55
+ ```text
56
+
57
+ **Pros**:
58
+
59
+ - Mathematically verifiable equivalence
60
+ - Addresses non-determinism directly
61
+ - Works for "ditch prototype" path
62
+
63
+ **Cons**:
64
+
65
+ - Symbolic execution has scalability limits
66
+ - May not capture all behavioral nuances
67
+ - Requires formal methods expertise
68
+
69
+ **Best For**: Critical systems where behavioral equivalence must be provable
70
+
71
+ ---
72
+
73
+ ### Option 2: Test-Contract Driven Migration (Golden Test Anchoring)
74
+
75
+ **Approach**: Generate comprehensive "golden tests" from the running prototype that serve as behavioral contracts. Any regenerated code must pass all golden tests.
76
+
77
+ **Academic Foundation**:
78
+
79
+ - **FreshBrew** (arXiv:2510.04852) validates migrations through 3 sequential gates: compilation → original tests pass → coverage preservation
80
+ - **Test-Driven Development for Code Generation** (arXiv:2402.13521) - TDD principles for LLM verification
81
+ - **HyClone** (arXiv:2508.01357) combines LLM understanding with execution-based validation
82
+
83
+ **How It Works**:
84
+
85
+ ```text
86
+ Vibe-Coded Prototype
87
+ ↓
88
+ [1] Dynamic analysis captures runtime behaviors (InspectCoder approach)
89
+ ↓
90
+ [2] Generate exhaustive golden test suite from actual execution
91
+ ↓
92
+ [3] Extract specifications as documentation (not primary anchor)
93
+ ↓
94
+ [4] Regenerate code from specs
95
+ ↓
96
+ [5] Validate against golden tests (3-gate validation)
97
+ ↓
98
+ Production Code (behaviorally verified)
99
+ ```text
100
+
101
+ **FreshBrew 3-Gate Validation**:
102
+
103
+ 1. **Gate 1**: Successful compilation
104
+ 2. **Gate 2**: Pass all original tests
105
+ 3. **Gate 3**: Test coverage within 5% of baseline
106
+
107
+ **Pros**:
108
+
109
+ - Practical and executable validation
110
+ - Works across different AI models/tools
111
+ - Captures actual runtime behavior
112
+ - Supports "build on prototype" path
113
+
114
+ **Cons**:
115
+
116
+ - Test coverage may miss edge cases
117
+ - Tests capture "what is" not "what should be"
118
+ - May preserve bugs from prototype
119
+
120
+ **Best For**: Teams wanting practical validation with existing testing infrastructure
121
+
122
+ ---
123
+
124
+ ### Option 3: Hybrid Strangler Fig with AI Validation
125
+
126
+ **Approach**: Keep the vibe-coded prototype running while incrementally replacing components with spec-driven modules, using **semantic clone detection** to ensure functional equivalence.
127
+
128
+ **Academic Foundation**:
129
+
130
+ - **Strangler Fig Pattern** (AWS, Microsoft architecture patterns)
131
+ - **HyClone** (arXiv:2508.01357) - LLM + execution validation for semantic clone detection
132
+ - **Legacy Code Modernization** (arXiv:2411.14971, arXiv:2407.04017)
133
+ - **Migrating Code at Scale** (arXiv:2504.09691) - Google's approach with TRANSAGENT
134
+
135
+ **How It Works**:
136
+
137
+ ```text
138
+ Vibe-Coded Prototype (Running in Production)
139
+ ↓
140
+ [1] Identify bounded context for migration
141
+ ↓
142
+ [2] Extract specs for that component only
143
+ ↓
144
+ [3] Generate new implementation from specs
145
+ ↓
146
+ [4] Run both implementations in parallel (shadow mode)
147
+ ↓
148
+ [5] Semantic clone detection validates equivalence
149
+ ↓
150
+ [6] Route traffic to new implementation
151
+ ↓
152
+ [7] Repeat for next component
153
+ ↓
154
+ Production (Incrementally Migrated)
155
+ ```text
156
+
157
+ **Key Insight from Google Paper**:
158
+ > "UniTrans uses test-cases as a benchmark and to guide code translation"
159
+
160
+ **Pros**:
161
+
162
+ - Zero downtime migration
163
+ - Rollback capability at any point
164
+ - Incremental risk management
165
+ - Ideal for brownfield projects
166
+
167
+ **Cons**:
168
+
169
+ - Longer migration timeline
170
+ - Operational complexity (running two systems)
171
+ - May never complete migration
172
+
173
+ **Best For**: Production systems that cannot afford downtime or risk
174
+
175
+ ---
176
+
177
+ ### Option 4: Knowledge Graph Preservation Architecture
178
+
179
+ **Approach**: Build a **semantic knowledge graph** of domain objects, business logic flows, and UX patterns from the vibe-coded prototype. Use this graph as a generation anchor rather than text specifications.
180
+
181
+ **Academic Foundation**:
182
+
183
+ - **RepoGraph** - Repository-level code graph for AI software engineering
184
+ - **RefExpo** (arXiv:2407.02620) - Dependency graph extraction
185
+ - **CodeKGC** (arXiv:2304.09048) - Knowledge graph construction from code
186
+ - **Knowledge-Based Multi-Agent Framework** (arXiv:2503.20536) for architecture design
187
+
188
+ **How It Works**:
189
+
190
+ ```text
191
+ Vibe-Coded Prototype
192
+ ↓
193
+ [1] Static analysis extracts code structure (RefExpo)
194
+ ↓
195
+ [2] Build knowledge graph of:
196
+ - Domain entities & relationships
197
+ - Business logic flows
198
+ - UX interaction patterns
199
+ - API contracts
200
+ - Data schemas
201
+ ↓
202
+ [3] Graph becomes "domain anchor" (not just text specs)
203
+ ↓
204
+ [4] Generate specs FROM the graph (structured, not free-form)
205
+ ↓
206
+ [5] Regenerate code with graph as context injection
207
+ ↓
208
+ [6] Validate regenerated code against graph constraints
209
+ ↓
210
+ Production Code (Graph-Anchored)
211
+ ```text
212
+
213
+ **Key Insight from RefExpo**:
214
+ > "Nodes can be methods, classes, files, modules. Logical dependencies are identified by how each component references others."
215
+
216
+ **Pros**:
217
+
218
+ - Captures structural relationships, not just behavior
219
+ - Graph provides deterministic anchoring
220
+ - Supports both "ditch" and "build on" paths
221
+ - Natural fit for DDD-based AI-DLC
222
+
223
+ **Cons**:
224
+
225
+ - Requires graph database infrastructure
226
+ - Complex implementation
227
+ - May miss dynamic behaviors
228
+
229
+ **Best For**: Complex domain-driven projects with rich entity relationships
230
+
231
+ ---
232
+
233
+ ### Option 5: Multi-Agent Orchestrated Transformation (MAOT)
234
+
235
+ **Approach**: Use a **specialized multi-agent system** where different agents handle extraction, specification, generation, and validation—with explicit human validation gates at each stage.
236
+
237
+ **Academic Foundation**:
238
+
239
+ - **Self-Organized Agents (SoA)** (arXiv:2404.02183) - Scalable multi-agent code generation
240
+ - **Codelevate** (arXiv:2511.07257) - Bridging prototype-production gap with MASA
241
+ - **LLM-Based Multi-Agent Systems for SE** (arXiv:2404.04834) - Survey of approaches
242
+ - **Seeking Specifications** (arXiv:2504.21061) - LLMs distinguish implemented vs intended behavior
243
+
244
+ **How It Works**:
245
+
246
+ ```text
247
+ Vibe-Coded Prototype
248
+ ↓
249
+ [Extractor Agent]
250
+ - Analyzes codebase structure
251
+ - Identifies domain boundaries
252
+ - Extracts behavioral patterns
253
+ ↓
254
+ [Specification Agent]
255
+ - Generates AI-DLC specs from extraction
256
+ - Distinguishes implemented vs intended (per arXiv:2504.21061)
257
+ - Human validates/modifies specs
258
+ ↓
259
+ [Generator Agent]
260
+ - Produces new implementation from specs
261
+ - Multiple generation attempts with diversity
262
+ ↓
263
+ [Validator Agent]
264
+ - Runs golden test suites
265
+ - Performs semantic equivalence checks
266
+ - Human validates final output
267
+ ↓
268
+ [Arbiter Agent]
269
+ - Selects best generation
270
+ - Documents deviations
271
+ - Coordinates rollback if needed
272
+ ↓
273
+ Production Code (Multi-Validated)
274
+ ```text
275
+
276
+ **Key Insight from Codelevate**:
277
+ > "Structured multi-agent frameworks emphasize role specialization and modularity, ensuring each agent operates with clear and coordinated purpose."
278
+
279
+ **Key Insight from "Seeking Specifications"**:
280
+ > "LLMs with advanced reasoning capabilities were resilient against the implementation-versus-intent problem—almost always able to identify bugs and target intended behavior."
281
+
282
+ **Pros**:
283
+
284
+ - Multiple validation layers
285
+ - Explicit human-AI collaboration points
286
+ - Scales with Self-Organized Agents approach
287
+ - Natural fit for irismd multi-agent architecture
288
+
289
+ **Cons**:
290
+
291
+ - Highest implementation complexity
292
+ - Coordination overhead
293
+ - Requires robust agent orchestration
294
+
295
+ **Best For**: Enterprise-scale transformations requiring auditability and governance
296
+
297
+ ---
298
+
299
+ ## Comparison Matrix
300
+
301
+ | Aspect | Option 1: Symbolic | Option 2: Test-Contract | Option 3: Strangler | Option 4: Knowledge Graph | Option 5: Multi-Agent |
302
+ |--------|-------------------|------------------------|---------------------|--------------------------|----------------------|
303
+ | **Primary Anchor** | Symbolic traces | Golden tests | Running system | Semantic graph | Multi-layer validation |
304
+ | **Non-determinism Solution** | Mathematical equivalence | Behavioral tests | A/B comparison | Graph constraints | Consensus across agents |
305
+ | **Brownfield Support** | Limited | Moderate | **Excellent** | Good | Good |
306
+ | **"Ditch Prototype" Path** | **Excellent** | Good | Poor | **Excellent** | **Excellent** |
307
+ | **"Build On" Path** | Poor | **Excellent** | **Excellent** | Good | Good |
308
+ | **Implementation Complexity** | High | Low | Medium | High | Very High |
309
+ | **Validation Rigor** | **Highest** | High | High | Medium | **Highest** |
310
+ | **Time to Value** | Long | **Short** | Medium | Long | Long |
311
+ | **AI-DLC Alignment** | High | High | Medium | **Highest** | **Highest** |
312
+
313
+ ---
314
+
315
+ ## The Non-Determinism Problem: Deep Dive
316
+
317
+ ### Evidence from Research
318
+
319
+ **"An Empirical Study of the Non-determinism of ChatGPT in Code Generation"** (arXiv:2308.02828, ACM TOSEM 2024)
320
+
321
+ Key findings:
322
+
323
+ - **75.76%** of CodeContests tasks produced different outputs across requests
324
+ - **51.00%** variance on APPS benchmark
325
+ - **47.56%** variance on HumanEval
326
+ - **Setting temperature=0 does NOT guarantee determinism**
327
+ - cuDNN benchmarking feature introduces hardware-level non-determinism
328
+
329
+ ### Implications for iris.md
330
+
331
+ 1. **Specs alone are insufficient** - Text specifications will be interpreted differently by different models
332
+ 2. **Need deterministic anchors** - Tests, traces, or graphs that constrain regeneration
333
+ 3. **Model versioning matters** - Same prompt on model version N vs N+1 produces different code
334
+ 4. **Tool-agnostic approach required** - Claude Code, Cursor, Copilot may all generate differently
335
+
336
+ ### Mitigation Strategies from Research
337
+
338
+ | Strategy | Source | Effectiveness |
339
+ |----------|--------|---------------|
340
+ | Greedy decoding (T=0) | arXiv:2511.07585 | Partial - not sufficient alone |
341
+ | Symbolic clustering | arXiv:2502.11620 | High - precise functional equivalence |
342
+ | Execution-based validation | arXiv:2508.01357 | High - validates actual behavior |
343
+ | RAG with code consistency | arXiv:2502.00611 | Medium - improves consistency |
344
+ | Consensus generation | arXiv:2307.01898 | High - 100% consensus possible with beam search |
345
+
346
+ ---
347
+
348
+ ## Brownfield Integration: Special Considerations
349
+
350
+ ### Research Insights
351
+
352
+ **"Contemporary Software Modernization: Perspectives and Challenges"** (arXiv:2407.04017)
353
+
354
+ > "When the legacy system has a high business value, it is a candidate for modernization by re-engineering or migration, independently of its internal quality."
355
+
356
+ **Key challenges for brownfield AI-DLC adoption**:
357
+
358
+ 1. Understanding existing architecture without documentation
359
+ 2. Preserving knowledge embedded in legacy code
360
+ 3. Incremental adoption without disrupting operations
361
+ 4. Managing technical debt during transformation
362
+
363
+ ### Recommended Approach for Brownfield
364
+
365
+ Combine **Option 3 (Strangler)** with **Option 2 (Test-Contract)**:
366
+
367
+ 1. Generate golden tests from running brownfield system
368
+ 2. Identify bounded context for first migration
369
+ 3. Extract specs for that context
370
+ 4. Generate new implementation
371
+ 5. Validate with golden tests
372
+ 6. Shadow deploy and compare
373
+ 7. Cut over when validated
374
+ 8. Repeat for next context
375
+
376
+ ---
377
+
378
+ ## Implementation Recommendation for iris.md
379
+
380
+ ### Primary Approach: Hybrid (Options 2 + 5)
381
+
382
+ **Test-Contract Driven with Multi-Agent Orchestration**
383
+
384
+ ```text
385
+ iris.md Architecture
386
+ ├── Extraction Layer
387
+ │ ├── Code Analyzer Agent
388
+ │ ├── Test Generator Agent
389
+ │ └── Knowledge Extractor Agent
390
+ │
391
+ ├── Specification Layer
392
+ │ ├── Spec Generator Agent
393
+ │ ├── Intent Synthesizer Agent
394
+ │ └── Human Validation Gate
395
+ │
396
+ ├── Generation Layer
397
+ │ ├── Multi-Model Generator (Claude, GPT, Gemini)
398
+ │ ├── Diversity Sampler
399
+ │ └── Best-of-N Selector
400
+ │
401
+ ├── Validation Layer
402
+ │ ├── Golden Test Runner
403
+ │ ├── Semantic Equivalence Checker
404
+ │ └── Human Validation Gate
405
+ │
406
+ └── Migration Layer
407
+ ├── Strangler Coordinator (for brownfield)
408
+ ├── Shadow Deployer
409
+ └── Cutover Manager
410
+ ```text
411
+
412
+ ### User Choice Points
413
+
414
+ 1. **Path Selection**:
415
+ - "Ditch prototype, regenerate from specs" → Full extraction + generation
416
+ - "Build on prototype" → Incremental strangler approach
417
+
418
+ 2. **Validation Rigor**:
419
+ - "Critical system" → Symbolic + test + manual validation
420
+ - "Internal tool" → Test validation only
421
+
422
+ 3. **Timeline**:
423
+ - "Fast migration" → Direct generation with test validation
424
+ - "Risk-averse" → Shadow deployment with gradual cutover
425
+
426
+ ---
427
+
428
+ ## Appendix A: Complete Academic Paper References
429
+
430
+ ### Specification Mining & Extraction
431
+
432
+ | Paper | arXiv ID | Key Contribution |
433
+ |-------|----------|------------------|
434
+ | AutoSpec: Enchanting Program Specification Synthesis | [2404.00762](https://arxiv.org/abs/2404.00762) | 79% automated verification through LLM + static analysis |
435
+ | SpecRover: Code Intent Extraction via LLMs | [2408.02232](https://arxiv.org/abs/2408.02232) | Intent extraction from code |
436
+ | SpecGen: Automated Generation of Formal Program Specifications | [2401.08807](https://arxiv.org/abs/2401.08807) | Formal spec generation |
437
+ | Seeking Specifications: Neuro-Symbolic Synthesis | [2504.21061](https://arxiv.org/abs/2504.21061) | LLMs distinguish implemented vs intended behavior |
438
+
439
+ ### Non-Determinism & Consistency
440
+
441
+ | Paper | arXiv ID | Key Contribution |
442
+ |-------|----------|------------------|
443
+ | Non-determinism of ChatGPT in Code Generation | [2308.02828](https://arxiv.org/abs/2308.02828) | 75% variance documented, T=0 insufficient |
444
+ | Generative AI Reproducibility and Consensus | [2307.01898](https://arxiv.org/abs/2307.01898) | 100% consensus achievable with beam search |
445
+ | LLM Output Drift: Cross-Provider Mitigation | [2511.07585](https://arxiv.org/abs/2511.07585) | Structured generation maintains determinism |
446
+ | Code Consistency with RAG | [2502.00611](https://arxiv.org/abs/2502.00611) | RAG improves consistency |
447
+
448
+ ### Prototype-to-Production Transformation
449
+
450
+ | Paper | arXiv ID | Key Contribution |
451
+ |-------|----------|------------------|
452
+ | Bridging Prototype-Production Gap (Codelevate) | [2511.07257](https://arxiv.org/abs/2511.07257) | Multi-agent system for Jupyter→production |
453
+ | Beyond Prototyping: Enterprise-Grade Frontend | [2512.06046](https://arxiv.org/abs/2512.06046) | AI4UI for production readiness |
454
+ | Lost in Code Generation: Role of Software Models | [2511.02475](https://arxiv.org/abs/2511.02475) | Reverse engineering AI-generated code challenges |
455
+ | Generating SAD from Source Code | [2511.05165](https://arxiv.org/abs/2511.05165) | Architecture extraction with LLMs |
456
+
457
+ ### Code Transformation & Refactoring
458
+
459
+ | Paper | arXiv ID | Key Contribution |
460
+ |-------|----------|------------------|
461
+ | Don't Transform Code, Code the Transforms | [2410.08806](https://arxiv.org/abs/2410.08806) | Explicit transforms > direct LLM rewriting |
462
+ | Refactoring with LLMs | [2510.03914](https://arxiv.org/abs/2510.03914) | GPT-4o has MORE semantic errors than DeepSeek |
463
+ | Code Change Automation: LLMs + TBE | [2402.07138](https://arxiv.org/abs/2402.07138) | Semantic-preserving transformations |
464
+
465
+ ### Legacy Code Modernization
466
+
467
+ | Paper | arXiv ID | Key Contribution |
468
+ |-------|----------|------------------|
469
+ | LLMs for Legacy Code Modernization | [2411.14971](https://arxiv.org/abs/2411.14971) | Documentation generation for MUMPS, ALC |
470
+ | Contemporary Software Modernization | [2407.04017](https://arxiv.org/abs/2407.04017) | 10 research challenges agenda |
471
+ | CodeMEnv: Benchmarking Code Migration | [2506.00894](https://arxiv.org/abs/2506.00894) | 26.50% pass@1 average |
472
+ | Empowering Application Modernization | [2506.10984](https://arxiv.org/abs/2506.10984) | Human-AI collaboration framework |
473
+ | Migrating Code at Scale (Google) | [2504.09691](https://arxiv.org/abs/2504.09691) | TRANSAGENT, UniTrans approaches |
474
+
475
+ ### Multi-Agent Systems for SE
476
+
477
+ | Paper | arXiv ID | Key Contribution |
478
+ |-------|----------|------------------|
479
+ | Self-Organized Agents (SoA) | [2404.02183](https://arxiv.org/abs/2404.02183) | Scalable multi-agent code generation |
480
+ | LLM-Based Multi-Agent Systems for SE | [2404.04834](https://arxiv.org/abs/2404.04834) | Comprehensive survey |
481
+ | Survey on Code Generation with LLM Agents | [2508.00083](https://arxiv.org/abs/2508.00083) | Single vs multi-agent taxonomy |
482
+ | AgentMesh | [2507.19902](https://arxiv.org/abs/2507.19902) | Cooperative multi-agent framework |
483
+ | NorMAS-SE | [2512.02329](https://arxiv.org/abs/2512.02329) | Normative reasoning for SE agents |
484
+
485
+ ### Semantic Equivalence & Clone Detection
486
+
487
+ | Paper | arXiv ID | Key Contribution |
488
+ |-------|----------|------------------|
489
+ | Assessing Correctness via Uncertainty Estimation | [2502.11620](https://arxiv.org/abs/2502.11620) | Symbolic clustering for functional equivalence |
490
+ | HyClone: LLM + Execution Validation | [2508.01357](https://arxiv.org/abs/2508.01357) | Two-stage semantic clone detection |
491
+ | Detecting Semantic Clones of Unseen Functionality | [2510.04143](https://arxiv.org/abs/2510.04143) | Contrastive learning for generalization |
492
+ | Deep Learning for Semantic Clone Detection | [2412.14739](https://arxiv.org/abs/2412.14739) | Type-4 clone detection survey |
493
+
494
+ ### Test-Driven & Behavioral Validation
495
+
496
+ | Paper | arXiv ID | Key Contribution |
497
+ |-------|----------|------------------|
498
+ | FreshBrew: Java Migration Benchmark | [2510.04852](https://arxiv.org/abs/2510.04852) | 3-gate validation protocol |
499
+ | Test-Driven Development for Code Generation | [2402.13521](https://arxiv.org/abs/2402.13521) | TDD principles for LLM verification |
500
+ | Automating Correctness Assessment | [2310.18834](https://arxiv.org/abs/2310.18834) | Semantic equivalence through testing |
501
+ | InspectCoder: Dynamic Analysis Self-Repair | [2510.18327](https://arxiv.org/abs/2510.18327) | Runtime behavior guides repairs |
502
+
503
+ ### Knowledge Graphs & Code Understanding
504
+
505
+ | Paper | arXiv ID | Key Contribution |
506
+ |-------|----------|------------------|
507
+ | RefExpo: Dependency Graph Extraction | [2407.02620](https://arxiv.org/abs/2407.02620) | Software project structure analysis |
508
+ | CodeKGC: Knowledge Graph from Code | [2304.09048](https://arxiv.org/abs/2304.09048) | Code-to-KG construction |
509
+ | Knowledge-Based Multi-Agent Architecture | [2503.20536](https://arxiv.org/abs/2503.20536) | Architecture design from KG |
510
+ | LLM-assisted Software Traceability | [2511.02434](https://arxiv.org/abs/2511.02434) | Architecture entity recognition |
511
+
512
+ ---
513
+
514
+ ## Appendix B: Industry References
515
+
516
+ ### Vibe Coding Context
517
+
518
+ - [Google Cloud: What is Vibe Coding](https://cloud.google.com/discover/what-is-vibe-coding)
519
+ - [Ajith's AI Pulse: Vibe Coding Future](https://ajithp.com/2025/04/14/vibe-coding-ai-software-development/)
520
+ - [Index.dev: How Vibe Coding Changes Development](https://www.index.dev/blog/vibe-coding-ai-development)
521
+ - [Beyond Vibe Coding Guide](https://beyond.addy.ie/)
522
+
523
+ ### Architecture Patterns
524
+
525
+ - [AWS: Strangler Fig Pattern](https://docs.aws.amazon.com/prescriptive-guidance/latest/modernization-decomposing-monoliths/strangler-fig.html)
526
+ - [Microsoft Azure: Strangler Fig Pattern](https://learn.microsoft.com/en-us/azure/architecture/patterns/strangler-fig)
527
+ - [Microservices.io: Strangler Application](https://microservices.io/patterns/refactoring/strangler-application.html)
528
+
529
+ ### Human-AI Collaboration
530
+
531
+ - [arXiv:2503.06195](https://arxiv.org/abs/2503.06195) - Human-AI Experience in IDEs
532
+ - [arXiv:2405.12731](https://arxiv.org/abs/2405.12731) - AI Transformation of Developer Routine by 2030
533
+ - [arXiv:2509.19708](https://arxiv.org/abs/2509.19708) - Measuring AI's True Impact on Productivity
534
+ - [arXiv:2504.20329](https://arxiv.org/abs/2504.20329) - AI Roles and Adoption
535
+ - [arXiv:2506.08945](https://arxiv.org/abs/2506.08945) - Global AI Diffusion in Coding
536
+
537
+ ---
538
+
539
+ ## Appendix C: Key Statistics
540
+
541
+ ### Vibe Coding Adoption (2025)
542
+
543
+ | Metric | Value | Source |
544
+ |--------|-------|--------|
545
+ | YC startups with 95% AI-generated code | 25% | TechCrunch |
546
+ | Developers using AI for half their code | 60% | GitHub 2024 Survey |
547
+ | Python functions from U.S. contributors AI-written | 30.1% | arXiv:2506.08945 |
548
+ | Developers adopted AI tools (early 2025) | 44% | Industry reports |
549
+
550
+ ### Non-Determinism Measurements
551
+
552
+ | Benchmark | Variance Rate | Source |
553
+ |-----------|---------------|--------|
554
+ | CodeContests | 75.76% | arXiv:2308.02828 |
555
+ | APPS | 51.00% | arXiv:2308.02828 |
556
+ | HumanEval | 47.56% | arXiv:2308.02828 |
557
+
558
+ ### Migration Benchmarks
559
+
560
+ | Metric | Value | Source |
561
+ |--------|-------|--------|
562
+ | CodeMEnv average pass@1 | 26.50% | arXiv:2506.00894 |
563
+ | GPT-4o best pass@1 | 43.84% | arXiv:2506.00894 |
564
+ | AutoSpec verification success | 79% | arXiv:2404.00762 |
565
+
566
+ ### Productivity Impact
567
+
568
+ | Metric | Before AI | After AI | Change | Source |
569
+ |--------|-----------|----------|--------|--------|
570
+ | Cycle time | 150.5h | 99.6h | -33.8% | arXiv:2509.19708 |
571
+ | Review time | 128.8h | 90.5h | -29.8% | arXiv:2509.19708 |
572
+ | Sprint completion | baseline | 30-40% faster | +35% | Industry reports |
573
+
574
+ ---
575
+
576
+ *This research document synthesizes 40+ academic papers and industry sources to inform the iris.md platform design for vibe-coded prototype to production transformation.*
577
+
578
+ *Last updated: 2025-12-09*