@ztothez/design-engineering 2.0.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (513) hide show
  1. package/LICENSE +15 -0
  2. package/README.md +448 -0
  3. package/ROADMAP.md +127 -0
  4. package/SKILL.md +698 -0
  5. package/V2-ROADMAP.md +431 -0
  6. package/V3-ROADMAP.md +605 -0
  7. package/V4-ROADMAP.md +283 -0
  8. package/clean-room-ux-design-spec.md +1431 -0
  9. package/dist/cli/aggregate-gates.d.ts +2 -0
  10. package/dist/cli/aggregate-gates.js +86 -0
  11. package/dist/cli/aggregate-gates.js.map +1 -0
  12. package/dist/cli/assess-maintainer-review.d.ts +2 -0
  13. package/dist/cli/assess-maintainer-review.js +72 -0
  14. package/dist/cli/assess-maintainer-review.js.map +1 -0
  15. package/dist/cli/audit.d.ts +2 -0
  16. package/dist/cli/audit.js +71 -0
  17. package/dist/cli/audit.js.map +1 -0
  18. package/dist/cli/compile-comparison-review.d.ts +2 -0
  19. package/dist/cli/compile-comparison-review.js +154 -0
  20. package/dist/cli/compile-comparison-review.js.map +1 -0
  21. package/dist/cli/compile-plan.d.ts +2 -0
  22. package/dist/cli/compile-plan.js +66 -0
  23. package/dist/cli/compile-plan.js.map +1 -0
  24. package/dist/cli/evaluate-corpus.d.ts +2 -0
  25. package/dist/cli/evaluate-corpus.js +65 -0
  26. package/dist/cli/evaluate-corpus.js.map +1 -0
  27. package/dist/cli/generate-react.d.ts +2 -0
  28. package/dist/cli/generate-react.js +83 -0
  29. package/dist/cli/generate-react.js.map +1 -0
  30. package/dist/cli/index.d.ts +2 -0
  31. package/dist/cli/index.js +58 -0
  32. package/dist/cli/index.js.map +1 -0
  33. package/dist/cli/portfolio.d.ts +2 -0
  34. package/dist/cli/portfolio.js +316 -0
  35. package/dist/cli/portfolio.js.map +1 -0
  36. package/dist/cli/quality-gate.d.ts +2 -0
  37. package/dist/cli/quality-gate.js +131 -0
  38. package/dist/cli/quality-gate.js.map +1 -0
  39. package/dist/cli/repair-react.d.ts +2 -0
  40. package/dist/cli/repair-react.js +163 -0
  41. package/dist/cli/repair-react.js.map +1 -0
  42. package/dist/cli/review-heuristics.d.ts +2 -0
  43. package/dist/cli/review-heuristics.js +68 -0
  44. package/dist/cli/review-heuristics.js.map +1 -0
  45. package/dist/cli/validate-brief.d.ts +2 -0
  46. package/dist/cli/validate-brief.js +58 -0
  47. package/dist/cli/validate-brief.js.map +1 -0
  48. package/dist/cli/validate-comparison.d.ts +2 -0
  49. package/dist/cli/validate-comparison.js +68 -0
  50. package/dist/cli/validate-comparison.js.map +1 -0
  51. package/dist/cli/validate-contract.d.ts +2 -0
  52. package/dist/cli/validate-contract.js +54 -0
  53. package/dist/cli/validate-contract.js.map +1 -0
  54. package/dist/cli/validate-design.d.ts +2 -0
  55. package/dist/cli/validate-design.js +53 -0
  56. package/dist/cli/validate-design.js.map +1 -0
  57. package/dist/cli/validate-information.d.ts +2 -0
  58. package/dist/cli/validate-information.js +53 -0
  59. package/dist/cli/validate-information.js.map +1 -0
  60. package/dist/cli/validate-trust.d.ts +2 -0
  61. package/dist/cli/validate-trust.js +53 -0
  62. package/dist/cli/validate-trust.js.map +1 -0
  63. package/dist/cli/verify-ui.d.ts +2 -0
  64. package/dist/cli/verify-ui.js +181 -0
  65. package/dist/cli/verify-ui.js.map +1 -0
  66. package/dist/src/acceptance/evaluator.d.ts +13 -0
  67. package/dist/src/acceptance/evaluator.js +201 -0
  68. package/dist/src/acceptance/evaluator.js.map +1 -0
  69. package/dist/src/acceptance/loader.d.ts +2 -0
  70. package/dist/src/acceptance/loader.js +18 -0
  71. package/dist/src/acceptance/loader.js.map +1 -0
  72. package/dist/src/acceptance/report.d.ts +2 -0
  73. package/dist/src/acceptance/report.js +18 -0
  74. package/dist/src/acceptance/report.js.map +1 -0
  75. package/dist/src/acceptance/schema.d.ts +64 -0
  76. package/dist/src/acceptance/schema.js +57 -0
  77. package/dist/src/acceptance/schema.js.map +1 -0
  78. package/dist/src/acceptance/types.d.ts +47 -0
  79. package/dist/src/acceptance/types.js +2 -0
  80. package/dist/src/acceptance/types.js.map +1 -0
  81. package/dist/src/aggregate/report.d.ts +2 -0
  82. package/dist/src/aggregate/report.js +33 -0
  83. package/dist/src/aggregate/report.js.map +1 -0
  84. package/dist/src/aggregate/runner.d.ts +2 -0
  85. package/dist/src/aggregate/runner.js +165 -0
  86. package/dist/src/aggregate/runner.js.map +1 -0
  87. package/dist/src/aggregate/schema.d.ts +182 -0
  88. package/dist/src/aggregate/schema.js +54 -0
  89. package/dist/src/aggregate/schema.js.map +1 -0
  90. package/dist/src/aggregate/types.d.ts +57 -0
  91. package/dist/src/aggregate/types.js +2 -0
  92. package/dist/src/aggregate/types.js.map +1 -0
  93. package/dist/src/audit/policy.d.ts +3 -0
  94. package/dist/src/audit/policy.js +45 -0
  95. package/dist/src/audit/policy.js.map +1 -0
  96. package/dist/src/audit/report.d.ts +2 -0
  97. package/dist/src/audit/report.js +32 -0
  98. package/dist/src/audit/report.js.map +1 -0
  99. package/dist/src/audit/rules/accessibility-name.d.ts +2 -0
  100. package/dist/src/audit/rules/accessibility-name.js +64 -0
  101. package/dist/src/audit/rules/accessibility-name.js.map +1 -0
  102. package/dist/src/audit/rules/component-size.d.ts +2 -0
  103. package/dist/src/audit/rules/component-size.js +27 -0
  104. package/dist/src/audit/rules/component-size.js.map +1 -0
  105. package/dist/src/audit/rules/credential-placeholder.d.ts +2 -0
  106. package/dist/src/audit/rules/credential-placeholder.js +83 -0
  107. package/dist/src/audit/rules/credential-placeholder.js.map +1 -0
  108. package/dist/src/audit/rules/helpers.d.ts +16 -0
  109. package/dist/src/audit/rules/helpers.js +64 -0
  110. package/dist/src/audit/rules/helpers.js.map +1 -0
  111. package/dist/src/audit/rules/index.d.ts +2 -0
  112. package/dist/src/audit/rules/index.js +23 -0
  113. package/dist/src/audit/rules/index.js.map +1 -0
  114. package/dist/src/audit/rules/interactive-integrity.d.ts +2 -0
  115. package/dist/src/audit/rules/interactive-integrity.js +111 -0
  116. package/dist/src/audit/rules/interactive-integrity.js.map +1 -0
  117. package/dist/src/audit/rules/mixed-responsibilities.d.ts +2 -0
  118. package/dist/src/audit/rules/mixed-responsibilities.js +39 -0
  119. package/dist/src/audit/rules/mixed-responsibilities.js.map +1 -0
  120. package/dist/src/audit/rules/mock-production-path.d.ts +2 -0
  121. package/dist/src/audit/rules/mock-production-path.js +39 -0
  122. package/dist/src/audit/rules/mock-production-path.js.map +1 -0
  123. package/dist/src/audit/rules/network-state.d.ts +2 -0
  124. package/dist/src/audit/rules/network-state.js +39 -0
  125. package/dist/src/audit/rules/network-state.js.map +1 -0
  126. package/dist/src/audit/rules/operational-claim.d.ts +2 -0
  127. package/dist/src/audit/rules/operational-claim.js +94 -0
  128. package/dist/src/audit/rules/operational-claim.js.map +1 -0
  129. package/dist/src/audit/rules/placeholder-interaction.d.ts +2 -0
  130. package/dist/src/audit/rules/placeholder-interaction.js +46 -0
  131. package/dist/src/audit/rules/placeholder-interaction.js.map +1 -0
  132. package/dist/src/audit/rules/raw-design-values.d.ts +2 -0
  133. package/dist/src/audit/rules/raw-design-values.js +97 -0
  134. package/dist/src/audit/rules/raw-design-values.js.map +1 -0
  135. package/dist/src/audit/scanner.d.ts +2 -0
  136. package/dist/src/audit/scanner.js +215 -0
  137. package/dist/src/audit/scanner.js.map +1 -0
  138. package/dist/src/audit/types.d.ts +62 -0
  139. package/dist/src/audit/types.js +2 -0
  140. package/dist/src/audit/types.js.map +1 -0
  141. package/dist/src/comparison/evaluator.d.ts +2 -0
  142. package/dist/src/comparison/evaluator.js +478 -0
  143. package/dist/src/comparison/evaluator.js.map +1 -0
  144. package/dist/src/comparison/loader.d.ts +3 -0
  145. package/dist/src/comparison/loader.js +26 -0
  146. package/dist/src/comparison/loader.js.map +1 -0
  147. package/dist/src/comparison/maintainer.d.ts +47 -0
  148. package/dist/src/comparison/maintainer.js +218 -0
  149. package/dist/src/comparison/maintainer.js.map +1 -0
  150. package/dist/src/comparison/report.d.ts +2 -0
  151. package/dist/src/comparison/report.js +48 -0
  152. package/dist/src/comparison/report.js.map +1 -0
  153. package/dist/src/comparison/schema.d.ts +464 -0
  154. package/dist/src/comparison/schema.js +502 -0
  155. package/dist/src/comparison/schema.js.map +1 -0
  156. package/dist/src/contracts/archetypes.d.ts +21 -0
  157. package/dist/src/contracts/archetypes.js +102 -0
  158. package/dist/src/contracts/archetypes.js.map +1 -0
  159. package/dist/src/contracts/journeys.d.ts +7 -0
  160. package/dist/src/contracts/journeys.js +32 -0
  161. package/dist/src/contracts/journeys.js.map +1 -0
  162. package/dist/src/contracts/report.d.ts +2 -0
  163. package/dist/src/contracts/report.js +33 -0
  164. package/dist/src/contracts/report.js.map +1 -0
  165. package/dist/src/contracts/schema.d.ts +1038 -0
  166. package/dist/src/contracts/schema.js +385 -0
  167. package/dist/src/contracts/schema.js.map +1 -0
  168. package/dist/src/contracts/validator.d.ts +12 -0
  169. package/dist/src/contracts/validator.js +303 -0
  170. package/dist/src/contracts/validator.js.map +1 -0
  171. package/dist/src/corpus/evaluator.d.ts +2 -0
  172. package/dist/src/corpus/evaluator.js +203 -0
  173. package/dist/src/corpus/evaluator.js.map +1 -0
  174. package/dist/src/corpus/loader.d.ts +2 -0
  175. package/dist/src/corpus/loader.js +20 -0
  176. package/dist/src/corpus/loader.js.map +1 -0
  177. package/dist/src/corpus/report.d.ts +2 -0
  178. package/dist/src/corpus/report.js +33 -0
  179. package/dist/src/corpus/report.js.map +1 -0
  180. package/dist/src/corpus/schema.d.ts +316 -0
  181. package/dist/src/corpus/schema.js +269 -0
  182. package/dist/src/corpus/schema.js.map +1 -0
  183. package/dist/src/design-intelligence/loader.d.ts +2 -0
  184. package/dist/src/design-intelligence/loader.js +21 -0
  185. package/dist/src/design-intelligence/loader.js.map +1 -0
  186. package/dist/src/design-intelligence/report.d.ts +2 -0
  187. package/dist/src/design-intelligence/report.js +36 -0
  188. package/dist/src/design-intelligence/report.js.map +1 -0
  189. package/dist/src/design-intelligence/schema.d.ts +838 -0
  190. package/dist/src/design-intelligence/schema.js +854 -0
  191. package/dist/src/design-intelligence/schema.js.map +1 -0
  192. package/dist/src/design-intelligence/validator.d.ts +2 -0
  193. package/dist/src/design-intelligence/validator.js +1371 -0
  194. package/dist/src/design-intelligence/validator.js.map +1 -0
  195. package/dist/src/design-plan/compiler.d.ts +8 -0
  196. package/dist/src/design-plan/compiler.js +288 -0
  197. package/dist/src/design-plan/compiler.js.map +1 -0
  198. package/dist/src/design-plan/report.d.ts +2 -0
  199. package/dist/src/design-plan/report.js +28 -0
  200. package/dist/src/design-plan/report.js.map +1 -0
  201. package/dist/src/design-plan/schema.d.ts +202 -0
  202. package/dist/src/design-plan/schema.js +76 -0
  203. package/dist/src/design-plan/schema.js.map +1 -0
  204. package/dist/src/generation/loader.d.ts +2 -0
  205. package/dist/src/generation/loader.js +21 -0
  206. package/dist/src/generation/loader.js.map +1 -0
  207. package/dist/src/generation/policy.d.ts +12 -0
  208. package/dist/src/generation/policy.js +62 -0
  209. package/dist/src/generation/policy.js.map +1 -0
  210. package/dist/src/generation/react-typescript.d.ts +6 -0
  211. package/dist/src/generation/react-typescript.js +538 -0
  212. package/dist/src/generation/react-typescript.js.map +1 -0
  213. package/dist/src/generation/report.d.ts +2 -0
  214. package/dist/src/generation/report.js +21 -0
  215. package/dist/src/generation/report.js.map +1 -0
  216. package/dist/src/generation/schema.d.ts +44 -0
  217. package/dist/src/generation/schema.js +50 -0
  218. package/dist/src/generation/schema.js.map +1 -0
  219. package/dist/src/generation/templates/tokens.d.ts +1 -0
  220. package/dist/src/generation/templates/tokens.js +59 -0
  221. package/dist/src/generation/templates/tokens.js.map +1 -0
  222. package/dist/src/heuristics/evaluator.d.ts +2 -0
  223. package/dist/src/heuristics/evaluator.js +65 -0
  224. package/dist/src/heuristics/evaluator.js.map +1 -0
  225. package/dist/src/heuristics/loader.d.ts +2 -0
  226. package/dist/src/heuristics/loader.js +21 -0
  227. package/dist/src/heuristics/loader.js.map +1 -0
  228. package/dist/src/heuristics/report.d.ts +3 -0
  229. package/dist/src/heuristics/report.js +31 -0
  230. package/dist/src/heuristics/report.js.map +1 -0
  231. package/dist/src/heuristics/schema.d.ts +198 -0
  232. package/dist/src/heuristics/schema.js +197 -0
  233. package/dist/src/heuristics/schema.js.map +1 -0
  234. package/dist/src/information-design/loader.d.ts +2 -0
  235. package/dist/src/information-design/loader.js +21 -0
  236. package/dist/src/information-design/loader.js.map +1 -0
  237. package/dist/src/information-design/report.d.ts +2 -0
  238. package/dist/src/information-design/report.js +27 -0
  239. package/dist/src/information-design/report.js.map +1 -0
  240. package/dist/src/information-design/schema.d.ts +370 -0
  241. package/dist/src/information-design/schema.js +329 -0
  242. package/dist/src/information-design/schema.js.map +1 -0
  243. package/dist/src/information-design/validator.d.ts +2 -0
  244. package/dist/src/information-design/validator.js +242 -0
  245. package/dist/src/information-design/validator.js.map +1 -0
  246. package/dist/src/interface-trust/loader.d.ts +2 -0
  247. package/dist/src/interface-trust/loader.js +21 -0
  248. package/dist/src/interface-trust/loader.js.map +1 -0
  249. package/dist/src/interface-trust/report.d.ts +2 -0
  250. package/dist/src/interface-trust/report.js +26 -0
  251. package/dist/src/interface-trust/report.js.map +1 -0
  252. package/dist/src/interface-trust/schema.d.ts +299 -0
  253. package/dist/src/interface-trust/schema.js +238 -0
  254. package/dist/src/interface-trust/schema.js.map +1 -0
  255. package/dist/src/interface-trust/validator.d.ts +2 -0
  256. package/dist/src/interface-trust/validator.js +283 -0
  257. package/dist/src/interface-trust/validator.js.map +1 -0
  258. package/dist/src/portfolio/adapter-report.d.ts +3 -0
  259. package/dist/src/portfolio/adapter-report.js +38 -0
  260. package/dist/src/portfolio/adapter-report.js.map +1 -0
  261. package/dist/src/portfolio/adapters.d.ts +37 -0
  262. package/dist/src/portfolio/adapters.js +325 -0
  263. package/dist/src/portfolio/adapters.js.map +1 -0
  264. package/dist/src/portfolio/evidence.d.ts +9 -0
  265. package/dist/src/portfolio/evidence.js +233 -0
  266. package/dist/src/portfolio/evidence.js.map +1 -0
  267. package/dist/src/portfolio/files.d.ts +8 -0
  268. package/dist/src/portfolio/files.js +77 -0
  269. package/dist/src/portfolio/files.js.map +1 -0
  270. package/dist/src/portfolio/fixture-server.d.ts +11 -0
  271. package/dist/src/portfolio/fixture-server.js +131 -0
  272. package/dist/src/portfolio/fixture-server.js.map +1 -0
  273. package/dist/src/portfolio/loader.d.ts +2 -0
  274. package/dist/src/portfolio/loader.js +21 -0
  275. package/dist/src/portfolio/loader.js.map +1 -0
  276. package/dist/src/portfolio/mcp.d.ts +186 -0
  277. package/dist/src/portfolio/mcp.js +117 -0
  278. package/dist/src/portfolio/mcp.js.map +1 -0
  279. package/dist/src/portfolio/promotion-schema.d.ts +220 -0
  280. package/dist/src/portfolio/promotion-schema.js +148 -0
  281. package/dist/src/portfolio/promotion-schema.js.map +1 -0
  282. package/dist/src/portfolio/promotion.d.ts +4 -0
  283. package/dist/src/portfolio/promotion.js +160 -0
  284. package/dist/src/portfolio/promotion.js.map +1 -0
  285. package/dist/src/portfolio/qualification-schema.d.ts +268 -0
  286. package/dist/src/portfolio/qualification-schema.js +112 -0
  287. package/dist/src/portfolio/qualification-schema.js.map +1 -0
  288. package/dist/src/portfolio/qualification.d.ts +4 -0
  289. package/dist/src/portfolio/qualification.js +157 -0
  290. package/dist/src/portfolio/qualification.js.map +1 -0
  291. package/dist/src/portfolio/registry.d.ts +34 -0
  292. package/dist/src/portfolio/registry.js +240 -0
  293. package/dist/src/portfolio/registry.js.map +1 -0
  294. package/dist/src/portfolio/report.d.ts +4 -0
  295. package/dist/src/portfolio/report.js +47 -0
  296. package/dist/src/portfolio/report.js.map +1 -0
  297. package/dist/src/portfolio/run-schema.d.ts +135 -0
  298. package/dist/src/portfolio/run-schema.js +81 -0
  299. package/dist/src/portfolio/run-schema.js.map +1 -0
  300. package/dist/src/portfolio/runner.d.ts +118 -0
  301. package/dist/src/portfolio/runner.js +423 -0
  302. package/dist/src/portfolio/runner.js.map +1 -0
  303. package/dist/src/portfolio/schema.d.ts +251 -0
  304. package/dist/src/portfolio/schema.js +317 -0
  305. package/dist/src/portfolio/schema.js.map +1 -0
  306. package/dist/src/portfolio/snapshot.d.ts +89 -0
  307. package/dist/src/portfolio/snapshot.js +548 -0
  308. package/dist/src/portfolio/snapshot.js.map +1 -0
  309. package/dist/src/portfolio/taxonomy-schema.d.ts +215 -0
  310. package/dist/src/portfolio/taxonomy-schema.js +74 -0
  311. package/dist/src/portfolio/taxonomy-schema.js.map +1 -0
  312. package/dist/src/portfolio/taxonomy.d.ts +5 -0
  313. package/dist/src/portfolio/taxonomy.js +236 -0
  314. package/dist/src/portfolio/taxonomy.js.map +1 -0
  315. package/dist/src/portfolio/vault.d.ts +53 -0
  316. package/dist/src/portfolio/vault.js +176 -0
  317. package/dist/src/portfolio/vault.js.map +1 -0
  318. package/dist/src/product-brief/loader.d.ts +2 -0
  319. package/dist/src/product-brief/loader.js +21 -0
  320. package/dist/src/product-brief/loader.js.map +1 -0
  321. package/dist/src/product-brief/report.d.ts +2 -0
  322. package/dist/src/product-brief/report.js +22 -0
  323. package/dist/src/product-brief/report.js.map +1 -0
  324. package/dist/src/product-brief/schema.d.ts +367 -0
  325. package/dist/src/product-brief/schema.js +272 -0
  326. package/dist/src/product-brief/schema.js.map +1 -0
  327. package/dist/src/product-brief/validator.d.ts +2 -0
  328. package/dist/src/product-brief/validator.js +251 -0
  329. package/dist/src/product-brief/validator.js.map +1 -0
  330. package/dist/src/product.d.ts +7 -0
  331. package/dist/src/product.js +28 -0
  332. package/dist/src/product.js.map +1 -0
  333. package/dist/src/quality-gate/report.d.ts +2 -0
  334. package/dist/src/quality-gate/report.js +46 -0
  335. package/dist/src/quality-gate/report.js.map +1 -0
  336. package/dist/src/quality-gate/runner.d.ts +2 -0
  337. package/dist/src/quality-gate/runner.js +175 -0
  338. package/dist/src/quality-gate/runner.js.map +1 -0
  339. package/dist/src/quality-gate/schema.d.ts +75 -0
  340. package/dist/src/quality-gate/schema.js +37 -0
  341. package/dist/src/quality-gate/schema.js.map +1 -0
  342. package/dist/src/quality-gate/types.d.ts +49 -0
  343. package/dist/src/quality-gate/types.js +2 -0
  344. package/dist/src/quality-gate/types.js.map +1 -0
  345. package/dist/src/repair/loader.d.ts +2 -0
  346. package/dist/src/repair/loader.js +11 -0
  347. package/dist/src/repair/loader.js.map +1 -0
  348. package/dist/src/repair/policy.d.ts +16 -0
  349. package/dist/src/repair/policy.js +65 -0
  350. package/dist/src/repair/policy.js.map +1 -0
  351. package/dist/src/repair/report.d.ts +2 -0
  352. package/dist/src/repair/report.js +32 -0
  353. package/dist/src/repair/report.js.map +1 -0
  354. package/dist/src/repair/runner.d.ts +17 -0
  355. package/dist/src/repair/runner.js +511 -0
  356. package/dist/src/repair/runner.js.map +1 -0
  357. package/dist/src/repair/schema.d.ts +264 -0
  358. package/dist/src/repair/schema.js +202 -0
  359. package/dist/src/repair/schema.js.map +1 -0
  360. package/dist/src/retrieval/report.d.ts +2 -0
  361. package/dist/src/retrieval/report.js +21 -0
  362. package/dist/src/retrieval/report.js.map +1 -0
  363. package/dist/src/retrieval/schema.d.ts +123 -0
  364. package/dist/src/retrieval/schema.js +77 -0
  365. package/dist/src/retrieval/schema.js.map +1 -0
  366. package/dist/src/retrieval/search.d.ts +26 -0
  367. package/dist/src/retrieval/search.js +415 -0
  368. package/dist/src/retrieval/search.js.map +1 -0
  369. package/dist/src/runtime/advanced-checks.d.ts +6 -0
  370. package/dist/src/runtime/advanced-checks.js +487 -0
  371. package/dist/src/runtime/advanced-checks.js.map +1 -0
  372. package/dist/src/runtime/composition-checks.d.ts +5 -0
  373. package/dist/src/runtime/composition-checks.js +307 -0
  374. package/dist/src/runtime/composition-checks.js.map +1 -0
  375. package/dist/src/runtime/interface-checks.d.ts +12 -0
  376. package/dist/src/runtime/interface-checks.js +224 -0
  377. package/dist/src/runtime/interface-checks.js.map +1 -0
  378. package/dist/src/runtime/policy.d.ts +13 -0
  379. package/dist/src/runtime/policy.js +97 -0
  380. package/dist/src/runtime/policy.js.map +1 -0
  381. package/dist/src/runtime/report.d.ts +2 -0
  382. package/dist/src/runtime/report.js +48 -0
  383. package/dist/src/runtime/report.js.map +1 -0
  384. package/dist/src/runtime/schema.d.ts +406 -0
  385. package/dist/src/runtime/schema.js +308 -0
  386. package/dist/src/runtime/schema.js.map +1 -0
  387. package/dist/src/runtime/types.d.ts +177 -0
  388. package/dist/src/runtime/types.js +2 -0
  389. package/dist/src/runtime/types.js.map +1 -0
  390. package/dist/src/runtime/verifier.d.ts +2 -0
  391. package/dist/src/runtime/verifier.js +1201 -0
  392. package/dist/src/runtime/verifier.js.map +1 -0
  393. package/dist/src/server.d.ts +2 -0
  394. package/dist/src/server.js +1352 -0
  395. package/dist/src/server.js.map +1 -0
  396. package/docs/installation.md +337 -0
  397. package/knowledge-base/INDEX.md +285 -0
  398. package/knowledge-base/benchmarks/aegisops/CALIBRATION.md +52 -0
  399. package/knowledge-base/benchmarks/aegisops/MANIFEST.md +56 -0
  400. package/knowledge-base/benchmarks/aegisops/SOURCE-EVIDENCE.md +45 -0
  401. package/knowledge-base/benchmarks/aegisops/acceptance-criteria.md +42 -0
  402. package/knowledge-base/benchmarks/aegisops/anti-patterns.md +19 -0
  403. package/knowledge-base/benchmarks/aegisops/attestations.template.yaml +3 -0
  404. package/knowledge-base/benchmarks/aegisops/attestations.yaml +115 -0
  405. package/knowledge-base/benchmarks/aegisops/journeys.json +91 -0
  406. package/knowledge-base/benchmarks/aegisops/product-contract.yaml +328 -0
  407. package/knowledge-base/benchmarks/azure-optimizer/SOURCE-EVIDENCE.md +26 -0
  408. package/knowledge-base/benchmarks/azure-optimizer/V2-IMPLEMENTATION.md +39 -0
  409. package/knowledge-base/benchmarks/azure-optimizer/acceptance-criteria.md +23 -0
  410. package/knowledge-base/benchmarks/azure-optimizer/anti-patterns.md +13 -0
  411. package/knowledge-base/benchmarks/azure-optimizer/journeys.json +88 -0
  412. package/knowledge-base/benchmarks/azure-optimizer/product-contract.yaml +216 -0
  413. package/knowledge-base/benchmarks/azure-optimizer/v2-human-review-methodology.yaml +171 -0
  414. package/knowledge-base/benchmarks/azure-optimizer/v2-journeys.json +139 -0
  415. package/knowledge-base/benchmarks/corpus/PROVENANCE.md +21 -0
  416. package/knowledge-base/benchmarks/corpus/README.md +30 -0
  417. package/knowledge-base/benchmarks/corpus/cases/anti-slop-negative/package.json +9 -0
  418. package/knowledge-base/benchmarks/corpus/cases/anti-slop-negative/src/FakeDashboard.tsx +10 -0
  419. package/knowledge-base/benchmarks/corpus/cases/anti-slop-positive/package.json +9 -0
  420. package/knowledge-base/benchmarks/corpus/cases/anti-slop-positive/src/Progress.tsx +15 -0
  421. package/knowledge-base/benchmarks/corpus/cases/architecture-negative/package.json +9 -0
  422. package/knowledge-base/benchmarks/corpus/cases/architecture-negative/src/OperationsPanel.tsx +40 -0
  423. package/knowledge-base/benchmarks/corpus/cases/architecture-positive/package.json +9 -0
  424. package/knowledge-base/benchmarks/corpus/cases/architecture-positive/src/Dashboard.tsx +17 -0
  425. package/knowledge-base/benchmarks/corpus/cases/architecture-positive/src/theme.css +15 -0
  426. package/knowledge-base/benchmarks/corpus/cases/task-incomplete/SOURCE-EVIDENCE.md +3 -0
  427. package/knowledge-base/benchmarks/corpus/cases/task-incomplete/journeys.json +20 -0
  428. package/knowledge-base/benchmarks/corpus/cases/task-incomplete/product-contract.yaml +78 -0
  429. package/knowledge-base/benchmarks/corpus/corpus.schema.yaml +159 -0
  430. package/knowledge-base/benchmarks/corpus/corpus.yaml +209 -0
  431. package/knowledge-base/benchmarks/interface-quality/README.md +26 -0
  432. package/knowledge-base/benchmarks/interface-quality/SOLO-MAINTAINER-TRACK.md +35 -0
  433. package/knowledge-base/benchmarks/interface-quality/comparison-methodology-v1.1.schema.yaml +288 -0
  434. package/knowledge-base/benchmarks/interface-quality/comparison-methodology.schema.yaml +235 -0
  435. package/knowledge-base/benchmarks/interface-quality/comparison-methodology.template.yaml +181 -0
  436. package/knowledge-base/benchmarks/interface-quality/evidence/example-runtime-report.json +11 -0
  437. package/knowledge-base/benchmarks/interface-quality/review-session.schema.yaml +14 -0
  438. package/knowledge-base/benchmarks/interface-quality/review.schema.yaml +296 -0
  439. package/knowledge-base/benchmarks/interface-quality/review.template.yaml +43 -0
  440. package/knowledge-base/benchmarks/portfolio-corpus/ADAPTERS.md +68 -0
  441. package/knowledge-base/benchmarks/portfolio-corpus/PORTFOLIO-RUNNER.md +131 -0
  442. package/knowledge-base/benchmarks/portfolio-corpus/PRODUCT-TASK-CONTRACTS.md +29 -0
  443. package/knowledge-base/benchmarks/portfolio-corpus/PROMOTED-RULES.md +31 -0
  444. package/knowledge-base/benchmarks/portfolio-corpus/archetype-profiles.yaml +26 -0
  445. package/knowledge-base/benchmarks/portfolio-corpus/product-task-profile.schema.yaml +105 -0
  446. package/knowledge-base/benchmarks/portfolio-corpus/registry.schema.yaml +188 -0
  447. package/knowledge-base/benchmarks/portfolio-corpus/registry.template.yaml +63 -0
  448. package/knowledge-base/benchmarks/portfolio-corpus/rule-fixtures/component-size-abstention.json +10 -0
  449. package/knowledge-base/benchmarks/portfolio-corpus/rule-fixtures/component-size-negative.json +10 -0
  450. package/knowledge-base/benchmarks/portfolio-corpus/rule-fixtures/component-size-positive.json +10 -0
  451. package/knowledge-base/benchmarks/portfolio-corpus/rule-fixtures/interactive-integrity-abstention.json +10 -0
  452. package/knowledge-base/benchmarks/portfolio-corpus/rule-fixtures/interactive-integrity-negative.json +10 -0
  453. package/knowledge-base/benchmarks/portfolio-corpus/rule-fixtures/interactive-integrity-positive.json +10 -0
  454. package/knowledge-base/benchmarks/portfolio-corpus/rule-fixtures/raw-design-values-abstention.json +10 -0
  455. package/knowledge-base/benchmarks/portfolio-corpus/rule-fixtures/raw-design-values-negative.json +10 -0
  456. package/knowledge-base/benchmarks/portfolio-corpus/rule-fixtures/raw-design-values-positive.json +10 -0
  457. package/knowledge-base/benchmarks/portfolio-corpus/rule-holdout-evaluation.template.json +14 -0
  458. package/knowledge-base/benchmarks/portfolio-corpus/rule-promotion-evidence.template.json +24 -0
  459. package/knowledge-base/benchmarks/portfolio-corpus/v3-command-evidence.template.json +17 -0
  460. package/knowledge-base/benchmarks/portfolio-corpus/v3-qualification-evidence.template.json +29 -0
  461. package/knowledge-base/benchmarks/scenestart/CALIBRATION.md +95 -0
  462. package/knowledge-base/benchmarks/scenestart/MANIFEST.md +53 -0
  463. package/knowledge-base/benchmarks/scenestart/SOURCE-EVIDENCE.md +43 -0
  464. package/knowledge-base/benchmarks/scenestart/acceptance-criteria.md +59 -0
  465. package/knowledge-base/benchmarks/scenestart/anti-patterns.md +26 -0
  466. package/knowledge-base/benchmarks/scenestart/attestations.template.yaml +3 -0
  467. package/knowledge-base/benchmarks/scenestart/attestations.yaml +21 -0
  468. package/knowledge-base/benchmarks/scenestart/human-review.md +99 -0
  469. package/knowledge-base/benchmarks/scenestart/human-review.template.md +105 -0
  470. package/knowledge-base/benchmarks/scenestart/journeys.json +141 -0
  471. package/knowledge-base/benchmarks/scenestart/product-contract.yaml +427 -0
  472. package/knowledge-base/dependencies.yaml +69 -0
  473. package/knowledge-base/design-intelligence/MASTER.md +87 -0
  474. package/knowledge-base/design-intelligence/asset-generation.md +66 -0
  475. package/knowledge-base/design-intelligence/brand-systems.md +69 -0
  476. package/knowledge-base/design-intelligence/closed-loop-repair.md +95 -0
  477. package/knowledge-base/design-intelligence/design-deliverable.schema.yaml +1194 -0
  478. package/knowledge-base/design-intelligence/design-deliverable.template.yaml +591 -0
  479. package/knowledge-base/design-intelligence/design-plan.md +78 -0
  480. package/knowledge-base/design-intelligence/design-plan.schema.yaml +621 -0
  481. package/knowledge-base/design-intelligence/figma-production.md +63 -0
  482. package/knowledge-base/design-intelligence/generation-adapter.md +72 -0
  483. package/knowledge-base/design-intelligence/generation-adapter.schema.yaml +47 -0
  484. package/knowledge-base/design-intelligence/iconography.md +46 -0
  485. package/knowledge-base/design-intelligence/information-design.md +104 -0
  486. package/knowledge-base/design-intelligence/information-design.schema.yaml +390 -0
  487. package/knowledge-base/design-intelligence/information-design.template.yaml +281 -0
  488. package/knowledge-base/design-intelligence/interaction-recovery-verification.md +72 -0
  489. package/knowledge-base/design-intelligence/interface-trust.md +103 -0
  490. package/knowledge-base/design-intelligence/interface-trust.schema.yaml +263 -0
  491. package/knowledge-base/design-intelligence/interface-trust.template.yaml +173 -0
  492. package/knowledge-base/design-intelligence/licensing-and-provenance.md +59 -0
  493. package/knowledge-base/design-intelligence/presentation-design.md +56 -0
  494. package/knowledge-base/design-intelligence/product-design-brief.md +67 -0
  495. package/knowledge-base/design-intelligence/product-design-brief.schema.yaml +279 -0
  496. package/knowledge-base/design-intelligence/product-design-brief.template.yaml +225 -0
  497. package/knowledge-base/design-intelligence/repair-request.schema.yaml +95 -0
  498. package/knowledge-base/design-intelligence/repair-request.template.yaml +39 -0
  499. package/knowledge-base/design-intelligence/visual-accessibility.md +56 -0
  500. package/knowledge-base/design-intelligence/visual-polish.md +172 -0
  501. package/knowledge-base/maintained/architecture/MASTER.md +22 -0
  502. package/knowledge-base/maintained/architecture/component-boundaries.md +30 -0
  503. package/knowledge-base/maintained/architecture/product-platforms.md +25 -0
  504. package/knowledge-base/maintained/architecture/quality-attributes-and-evaluation.md +35 -0
  505. package/knowledge-base/maintained/product-patterns/MASTER.md +10 -0
  506. package/knowledge-base/maintained/product-patterns/ai-workspaces.md +26 -0
  507. package/knowledge-base/maintained/product-patterns/operational-dashboards.md +22 -0
  508. package/knowledge-base/provenance.yaml +196 -0
  509. package/knowledge-base/retrieval-scope.yaml +43 -0
  510. package/knowledge-base/usability-evaluation/HEURISTIC_EVALUATION.md +115 -0
  511. package/knowledge-base/usability-evaluation/heuristic-review.schema.yaml +210 -0
  512. package/knowledge-base/usability-evaluation/heuristic-review.template.yaml +37 -0
  513. package/package.json +133 -0
@@ -0,0 +1,77 @@
1
+ import { isAbsolute, matchesGlob, relative, sep } from "node:path";
2
+ export const DEFAULT_PRUNED_DIRECTORIES = new Set([
3
+ ".git",
4
+ ".next",
5
+ ".nuxt",
6
+ ".output",
7
+ ".svelte-kit",
8
+ ".turbo",
9
+ ".venv",
10
+ "__pycache__",
11
+ "build",
12
+ "coverage",
13
+ "data",
14
+ "dist",
15
+ "models",
16
+ "node_modules",
17
+ "playwright-report",
18
+ "test-results",
19
+ "uploads",
20
+ "venv",
21
+ "vendor",
22
+ ]);
23
+ const PROHIBITED_FILE_PATTERNS = [
24
+ ".env",
25
+ ".env.*",
26
+ "**/.env",
27
+ "**/.env.*",
28
+ "*.db",
29
+ "**/*.db",
30
+ "*.sqlite",
31
+ "**/*.sqlite",
32
+ "*.sqlite3",
33
+ "**/*.sqlite3",
34
+ "*.pem",
35
+ "**/*.pem",
36
+ "*.key",
37
+ "**/*.key",
38
+ "*.p12",
39
+ "**/*.p12",
40
+ "*.pfx",
41
+ "**/*.pfx",
42
+ "id_rsa",
43
+ "**/id_rsa",
44
+ "credentials.json",
45
+ "**/credentials.json",
46
+ "service-account.json",
47
+ "**/service-account.json",
48
+ "*.zip",
49
+ "**/*.zip",
50
+ "*.tar",
51
+ "**/*.tar",
52
+ "*.tgz",
53
+ "**/*.tgz",
54
+ ];
55
+ export function portablePath(path) {
56
+ return path.split(sep).join("/");
57
+ }
58
+ export function isContained(root, candidate) {
59
+ const relation = relative(root, candidate);
60
+ return relation === "" || (!relation.startsWith(`..${sep}`) && relation !== ".." && !isAbsolute(relation));
61
+ }
62
+ export function matchesAny(path, patterns) {
63
+ return patterns.some((pattern) => matchesGlob(path, pattern));
64
+ }
65
+ export function isProhibitedFile(path) {
66
+ return matchesAny(path, PROHIBITED_FILE_PATTERNS);
67
+ }
68
+ export function containsPrunedDirectory(path) {
69
+ return path.split("/").some((segment) => DEFAULT_PRUNED_DIRECTORIES.has(segment));
70
+ }
71
+ export function isCustomExcluded(path, patterns) {
72
+ return matchesAny(path, patterns);
73
+ }
74
+ export function isIncluded(path, patterns) {
75
+ return matchesAny(path, patterns);
76
+ }
77
+ //# sourceMappingURL=files.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"files.js","sourceRoot":"","sources":["../../../src/portfolio/files.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,WAAW,EAAE,QAAQ,EAAE,GAAG,EAAE,MAAM,WAAW,CAAC;AAEnE,MAAM,CAAC,MAAM,0BAA0B,GAAG,IAAI,GAAG,CAAC;IAChD,MAAM;IACN,OAAO;IACP,OAAO;IACP,SAAS;IACT,aAAa;IACb,QAAQ;IACR,OAAO;IACP,aAAa;IACb,OAAO;IACP,UAAU;IACV,MAAM;IACN,MAAM;IACN,QAAQ;IACR,cAAc;IACd,mBAAmB;IACnB,cAAc;IACd,SAAS;IACT,MAAM;IACN,QAAQ;CACT,CAAC,CAAC;AAEH,MAAM,wBAAwB,GAAG;IAC/B,MAAM;IACN,QAAQ;IACR,SAAS;IACT,WAAW;IACX,MAAM;IACN,SAAS;IACT,UAAU;IACV,aAAa;IACb,WAAW;IACX,cAAc;IACd,OAAO;IACP,UAAU;IACV,OAAO;IACP,UAAU;IACV,OAAO;IACP,UAAU;IACV,OAAO;IACP,UAAU;IACV,QAAQ;IACR,WAAW;IACX,kBAAkB;IAClB,qBAAqB;IACrB,sBAAsB;IACtB,yBAAyB;IACzB,OAAO;IACP,UAAU;IACV,OAAO;IACP,UAAU;IACV,OAAO;IACP,UAAU;CACX,CAAC;AAEF,MAAM,UAAU,YAAY,CAAC,IAAY;IACvC,OAAO,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;AACnC,CAAC;AAED,MAAM,UAAU,WAAW,CAAC,IAAY,EAAE,SAAiB;IACzD,MAAM,QAAQ,GAAG,QAAQ,CAAC,IAAI,EAAE,SAAS,CAAC,CAAC;IAC3C,OAAO,QAAQ,KAAK,EAAE,IAAI,CAAC,CAAC,QAAQ,CAAC,UAAU,CAAC,KAAK,GAAG,EAAE,CAAC,IAAI,QAAQ,KAAK,IAAI,IAAI,CAAC,UAAU,CAAC,QAAQ,CAAC,CAAC,CAAC;AAC7G,CAAC;AAED,MAAM,UAAU,UAAU,CAAC,IAAY,EAAE,QAA2B;IAClE,OAAO,QAAQ,CAAC,IAAI,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC,WAAW,CAAC,IAAI,EAAE,OAAO,CAAC,CAAC,CAAC;AAChE,CAAC;AAED,MAAM,UAAU,gBAAgB,CAAC,IAAY;IAC3C,OAAO,UAAU,CAAC,IAAI,EAAE,wBAAwB,CAAC,CAAC;AACpD,CAAC;AAED,MAAM,UAAU,uBAAuB,CAAC,IAAY;IAClD,OAAO,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,IAAI,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC,0BAA0B,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC;AACpF,CAAC;AAED,MAAM,UAAU,gBAAgB,CAAC,IAAY,EAAE,QAA2B;IACxE,OAAO,UAAU,CAAC,IAAI,EAAE,QAAQ,CAAC,CAAC;AACpC,CAAC;AAED,MAAM,UAAU,UAAU,CAAC,IAAY,EAAE,QAA2B;IAClE,OAAO,UAAU,CAAC,IAAI,EAAE,QAAQ,CAAC,CAAC;AACpC,CAAC"}
@@ -0,0 +1,11 @@
1
+ import type { PortfolioSnapshot } from "./snapshot.js";
2
+ export type PortfolioFixtureServer = {
3
+ origin: string;
4
+ url: string;
5
+ directory: string;
6
+ port: number;
7
+ readinessPath: string;
8
+ startedAt: string;
9
+ close(): Promise<void>;
10
+ };
11
+ export declare function startPortfolioFixtureServer(snapshot: PortfolioSnapshot): Promise<PortfolioFixtureServer>;
@@ -0,0 +1,131 @@
1
+ import { createServer } from "node:http";
2
+ import { readFile, realpath, stat } from "node:fs/promises";
3
+ import { extname, join, normalize, relative, resolve, sep } from "node:path";
4
+ const MIME_TYPES = {
5
+ ".css": "text/css; charset=utf-8",
6
+ ".html": "text/html; charset=utf-8",
7
+ ".ico": "image/x-icon",
8
+ ".jpeg": "image/jpeg",
9
+ ".jpg": "image/jpeg",
10
+ ".js": "text/javascript; charset=utf-8",
11
+ ".json": "application/json; charset=utf-8",
12
+ ".png": "image/png",
13
+ ".svg": "image/svg+xml",
14
+ ".txt": "text/plain; charset=utf-8",
15
+ ".webp": "image/webp",
16
+ ".woff": "font/woff",
17
+ ".woff2": "font/woff2",
18
+ };
19
+ function contained(root, candidate) {
20
+ const path = relative(root, candidate);
21
+ return path === "" || (!path.startsWith(`..${sep}`) && path !== "..");
22
+ }
23
+ async function responseFile(root, requestPath) {
24
+ let decoded;
25
+ try {
26
+ decoded = decodeURIComponent(requestPath);
27
+ }
28
+ catch {
29
+ return undefined;
30
+ }
31
+ if (decoded.includes("\0"))
32
+ return undefined;
33
+ const normalized = normalize(decoded).replace(/^[/\\]+/, "");
34
+ const candidate = resolve(root, normalized || "index.html");
35
+ if (!contained(root, candidate))
36
+ return undefined;
37
+ try {
38
+ const candidateStats = await stat(candidate);
39
+ const file = candidateStats.isDirectory() ? join(candidate, "index.html") : candidate;
40
+ const canonical = await realpath(file);
41
+ if (!contained(root, canonical) || !(await stat(canonical)).isFile())
42
+ return undefined;
43
+ return canonical;
44
+ }
45
+ catch {
46
+ const fallback = await realpath(join(root, "index.html")).catch(() => undefined);
47
+ return fallback && contained(root, fallback) ? fallback : undefined;
48
+ }
49
+ }
50
+ async function waitUntilReady(url, timeoutMs = 10_000) {
51
+ const deadline = Date.now() + timeoutMs;
52
+ let lastError = "no response";
53
+ while (Date.now() < deadline) {
54
+ try {
55
+ const response = await fetch(url, { signal: AbortSignal.timeout(1_000) });
56
+ if (response.ok)
57
+ return;
58
+ lastError = `HTTP ${response.status}`;
59
+ }
60
+ catch (error) {
61
+ lastError = error instanceof Error ? error.message : String(error);
62
+ }
63
+ await new Promise((resolvePromise) => setTimeout(resolvePromise, 100));
64
+ }
65
+ throw new Error(`Static fixture did not become ready: ${lastError}`);
66
+ }
67
+ function listen(server, port) {
68
+ return new Promise((resolvePromise, rejectPromise) => {
69
+ server.once("error", rejectPromise);
70
+ server.listen(port, "127.0.0.1", () => {
71
+ server.off("error", rejectPromise);
72
+ resolvePromise();
73
+ });
74
+ });
75
+ }
76
+ export async function startPortfolioFixtureServer(snapshot) {
77
+ const verification = snapshot.project.declaration.verification;
78
+ if (!verification)
79
+ throw new Error("The project does not declare built-in browser verification.");
80
+ const candidate = resolve(snapshot.snapshotRoot, verification.serveDirectory);
81
+ const directory = await realpath(candidate);
82
+ if (!contained(snapshot.snapshotRoot, directory) || !(await stat(directory)).isDirectory()) {
83
+ throw new Error("The declared fixture directory is unavailable or escapes the snapshot.");
84
+ }
85
+ const server = createServer(async (request, response) => {
86
+ try {
87
+ const requestUrl = new URL(request.url ?? "/", "http://127.0.0.1");
88
+ const file = await responseFile(directory, requestUrl.pathname);
89
+ if (!file) {
90
+ response.writeHead(404, { "content-type": "text/plain; charset=utf-8" });
91
+ response.end("Not found");
92
+ return;
93
+ }
94
+ const body = await readFile(file);
95
+ response.writeHead(200, {
96
+ "cache-control": "no-store",
97
+ "content-length": body.byteLength,
98
+ "content-type": MIME_TYPES[extname(file).toLowerCase()] ?? "application/octet-stream",
99
+ "x-content-type-options": "nosniff",
100
+ });
101
+ response.end(body);
102
+ }
103
+ catch (error) {
104
+ console.error(`[portfolio-fixture] ${error instanceof Error ? error.message : String(error)}`);
105
+ response.writeHead(500, { "content-type": "text/plain; charset=utf-8" });
106
+ response.end("Fixture server error");
107
+ }
108
+ });
109
+ await listen(server, verification.port);
110
+ const origin = `http://127.0.0.1:${verification.port}`;
111
+ try {
112
+ await waitUntilReady(new URL(verification.readinessPath, origin).toString());
113
+ }
114
+ catch (error) {
115
+ await new Promise((resolvePromise) => server.close(() => resolvePromise()));
116
+ throw error;
117
+ }
118
+ return {
119
+ origin,
120
+ url: new URL(verification.route, origin).toString(),
121
+ directory: verification.serveDirectory,
122
+ port: verification.port,
123
+ readinessPath: verification.readinessPath,
124
+ startedAt: new Date().toISOString(),
125
+ close: () => new Promise((resolvePromise, rejectPromise) => {
126
+ server.close((error) => error ? rejectPromise(error) : resolvePromise());
127
+ server.closeAllConnections();
128
+ }),
129
+ };
130
+ }
131
+ //# sourceMappingURL=fixture-server.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"fixture-server.js","sourceRoot":"","sources":["../../../src/portfolio/fixture-server.ts"],"names":[],"mappings":"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"}
@@ -0,0 +1,2 @@
1
+ import { type PortfolioRegistry } from "./schema.js";
2
+ export declare function loadPortfolioRegistry(path: string): Promise<PortfolioRegistry>;
@@ -0,0 +1,21 @@
1
+ import { readFile, stat } from "node:fs/promises";
2
+ import { extname, resolve } from "node:path";
3
+ import { parse } from "yaml";
4
+ import { portfolioRegistrySchema } from "./schema.js";
5
+ const MAX_REGISTRY_BYTES = 2 * 1024 * 1024;
6
+ export async function loadPortfolioRegistry(path) {
7
+ const resolvedPath = resolve(path);
8
+ if (!/^\.(?:json|ya?ml)$/i.test(extname(resolvedPath))) {
9
+ throw new Error("Portfolio registries must end in .json, .yaml, or .yml");
10
+ }
11
+ const fileStats = await stat(resolvedPath);
12
+ if (!fileStats.isFile())
13
+ throw new Error("Portfolio registry path is not a regular file");
14
+ if (fileStats.size > MAX_REGISTRY_BYTES) {
15
+ throw new Error(`Portfolio registry exceeds ${MAX_REGISTRY_BYTES} bytes`);
16
+ }
17
+ const content = await readFile(resolvedPath, "utf8");
18
+ const parsed = extname(resolvedPath).toLowerCase() === ".json" ? JSON.parse(content) : parse(content);
19
+ return portfolioRegistrySchema.parse(parsed);
20
+ }
21
+ //# sourceMappingURL=loader.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"loader.js","sourceRoot":"","sources":["../../../src/portfolio/loader.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,IAAI,EAAE,MAAM,kBAAkB,CAAC;AAClD,OAAO,EAAE,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAE7C,OAAO,EAAE,KAAK,EAAE,MAAM,MAAM,CAAC;AAE7B,OAAO,EAAE,uBAAuB,EAA0B,MAAM,aAAa,CAAC;AAE9E,MAAM,kBAAkB,GAAG,CAAC,GAAG,IAAI,GAAG,IAAI,CAAC;AAE3C,MAAM,CAAC,KAAK,UAAU,qBAAqB,CAAC,IAAY;IACtD,MAAM,YAAY,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IACnC,IAAI,CAAC,qBAAqB,CAAC,IAAI,CAAC,OAAO,CAAC,YAAY,CAAC,CAAC,EAAE,CAAC;QACvD,MAAM,IAAI,KAAK,CAAC,wDAAwD,CAAC,CAAC;IAC5E,CAAC;IACD,MAAM,SAAS,GAAG,MAAM,IAAI,CAAC,YAAY,CAAC,CAAC;IAC3C,IAAI,CAAC,SAAS,CAAC,MAAM,EAAE;QAAE,MAAM,IAAI,KAAK,CAAC,+CAA+C,CAAC,CAAC;IAC1F,IAAI,SAAS,CAAC,IAAI,GAAG,kBAAkB,EAAE,CAAC;QACxC,MAAM,IAAI,KAAK,CAAC,8BAA8B,kBAAkB,QAAQ,CAAC,CAAC;IAC5E,CAAC;IACD,MAAM,OAAO,GAAG,MAAM,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAC,CAAC;IACrD,MAAM,MAAM,GAAG,OAAO,CAAC,YAAY,CAAC,CAAC,WAAW,EAAE,KAAK,OAAO,CAAC,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC;IACtG,OAAO,uBAAuB,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC;AAC/C,CAAC"}
@@ -0,0 +1,186 @@
1
+ export declare function listPortfolioProjectsForMcp(): Promise<{
2
+ version: string;
3
+ registryId: string;
4
+ projects: {
5
+ id: string;
6
+ cohort: "development" | "holdout";
7
+ archetype: "operational-dashboard" | "ai-workspace" | "content-site" | "utility" | "full-stack-workflow" | "other";
8
+ adapter: "react-vite" | "nextjs" | "angular" | "static-web" | "node-python-fullstack" | "python-source" | undefined;
9
+ capabilities: {
10
+ stage: "lint" | "typecheck" | "unit-test" | "source-audit" | "production-build" | "local-fixture-server" | "browser-journeys" | "export-verification";
11
+ status: "not-applicable" | "supported" | "unsupported";
12
+ }[];
13
+ }[];
14
+ }>;
15
+ export declare function readPortfolioReportForMcp(runId: string, projectId?: string): Promise<{
16
+ version: string;
17
+ runId: string;
18
+ mode: "baseline" | "cohort";
19
+ cohort: "development" | "holdout" | undefined;
20
+ registryId: string;
21
+ toolVersion: string;
22
+ startedAt: string;
23
+ completedAt: string;
24
+ resultFingerprint: string;
25
+ passed: boolean;
26
+ summary: {
27
+ passed: number;
28
+ findings: number;
29
+ limitations: number;
30
+ unsafeConfiguration: number;
31
+ sourceMutation: number;
32
+ };
33
+ projects: {
34
+ projectId: string;
35
+ cohort: "development" | "holdout";
36
+ adapter: string | undefined;
37
+ sourceDigest: string | undefined;
38
+ sourceRevision: string | undefined;
39
+ status: "findings" | "passed" | "limitations" | "unsafe-configuration" | "source-mutation";
40
+ stages: import("./runner.js").PortfolioRunStage[];
41
+ artifacts: import("./runner.js").PortfolioArtifact[];
42
+ }[];
43
+ }>;
44
+ export declare function getCrossProductEvaluationForMcp(runId: string): Promise<{
45
+ version: "1.0.0";
46
+ toolVersion: string;
47
+ runId: string;
48
+ evaluatedAt: string;
49
+ projectsCount: number;
50
+ projectSummaries: {
51
+ projectId: string;
52
+ domain: string;
53
+ archetype: string;
54
+ framework: string;
55
+ dimensions: Record<"accessibility" | "information-design" | "architecture" | "product-task" | "interface-trust" | "visual-polish" | "responsive" | "runtime-reliability" | "audit-precision", {
56
+ eligible: number;
57
+ passed: number;
58
+ findings: number;
59
+ limitations: number;
60
+ abstentions: number;
61
+ }>;
62
+ totals: {
63
+ eligible: number;
64
+ passed: number;
65
+ findings: number;
66
+ limitations: number;
67
+ abstentions: number;
68
+ };
69
+ }[];
70
+ dimensionTotals: Record<"accessibility" | "information-design" | "architecture" | "product-task" | "interface-trust" | "visual-polish" | "responsive" | "runtime-reliability" | "audit-precision", {
71
+ eligible: number;
72
+ passed: number;
73
+ findings: number;
74
+ limitations: number;
75
+ abstentions: number;
76
+ }>;
77
+ recurrenceTaxonomy: {
78
+ ruleId: string;
79
+ category: string;
80
+ dimension: "accessibility" | "information-design" | "architecture" | "product-task" | "interface-trust" | "visual-polish" | "responsive" | "runtime-reliability" | "audit-precision";
81
+ affectedProjects: string[];
82
+ affectedDomains: string[];
83
+ totalOccurrences: number;
84
+ sampleMessages: string[];
85
+ }[];
86
+ stackCoverage: {
87
+ framework: string;
88
+ archetype: string;
89
+ projectsCount: number;
90
+ dimensionsCovered: ("accessibility" | "information-design" | "architecture" | "product-task" | "interface-trust" | "visual-polish" | "responsive" | "runtime-reliability" | "audit-precision")[];
91
+ }[];
92
+ annotations: {
93
+ supplied: number;
94
+ confirmedFalsePositives: number;
95
+ confirmedFalseNegatives: number;
96
+ records: {
97
+ ruleId: string;
98
+ projectId: string;
99
+ type: "false-positive" | "false-negative";
100
+ rationale: string;
101
+ reviewedBy: string;
102
+ reviewedAt: string;
103
+ findingId?: string | undefined;
104
+ }[];
105
+ };
106
+ passed: boolean;
107
+ }>;
108
+ export declare function evaluateRulePromotionForMcp(candidatePath: string, evidencePath: string, devRunId?: string, holdoutRunId?: string): Promise<{
109
+ version: "1.1.0";
110
+ candidateId: string;
111
+ title: string;
112
+ evaluatedAt: string;
113
+ decision: "rejected" | "promoted";
114
+ criteria: {
115
+ c1_independentAuthoring: boolean;
116
+ c2_recurrenceOrSafety: boolean;
117
+ c3_positiveNegativeFixtures: boolean;
118
+ c4_falsePositiveAnalysis: boolean;
119
+ c5_existingTestsPass: boolean;
120
+ c6_holdoutValidationPass: boolean;
121
+ c7_sourceUnchanged: boolean;
122
+ };
123
+ holdoutImpact: {
124
+ projectId: string;
125
+ status: "unverified" | "abstained" | "benefited" | "unaffected" | "regressed";
126
+ details: string;
127
+ }[];
128
+ evaluationComplete: boolean;
129
+ failureReasons: string[];
130
+ passed: boolean;
131
+ rejectionReason?: string | undefined;
132
+ promotedArtifacts?: {
133
+ documentationPath: string;
134
+ testReference: string;
135
+ reportCode: string;
136
+ migrationGuidance: string;
137
+ } | undefined;
138
+ }>;
139
+ export declare function evaluateV3QualificationForMcp(evidencePath: string, devRunId?: string, holdoutRunId?: string): Promise<{
140
+ version: "1.1.0";
141
+ qualifiedAt: string;
142
+ targets: {
143
+ eligibleProjectsCount: number;
144
+ productDomainsCount: number;
145
+ frontendStacksCount: number;
146
+ interfaceArchetypesCount: number;
147
+ lockedHoldoutProjectsCount: number;
148
+ pathTypes: {
149
+ sourceOnly: boolean;
150
+ browserOnly: boolean;
151
+ fullStack: boolean;
152
+ };
153
+ sourceMutationViolations: number;
154
+ privateLeakageViolations: number;
155
+ existingGatesPassing: boolean;
156
+ };
157
+ ciFixtures: {
158
+ registryViolations: boolean;
159
+ snapshotViolations: boolean;
160
+ adapterCases: boolean;
161
+ comparisonSafety: boolean;
162
+ privacyBoundaries: boolean;
163
+ rulePromotionPaths: boolean;
164
+ };
165
+ disallowedClaimsExcluded: boolean;
166
+ supportedClaims: string[];
167
+ disallowedClaimsDetected: string[];
168
+ criteria: {
169
+ evidenceIntegrity: boolean;
170
+ eligibleProjects: boolean;
171
+ productDomains: boolean;
172
+ frontendStacks: boolean;
173
+ interfaceArchetypes: boolean;
174
+ lockedHoldouts: boolean;
175
+ benchmarkPaths: boolean;
176
+ cohortReportsComplete: boolean;
177
+ sourceRootsUnchanged: boolean;
178
+ privateDistributionClean: boolean;
179
+ existingGates: boolean;
180
+ ciFixtures: boolean;
181
+ rulePromotionEvidence: boolean;
182
+ claimBoundary: boolean;
183
+ };
184
+ failureReasons: string[];
185
+ passed: boolean;
186
+ }>;
@@ -0,0 +1,117 @@
1
+ import { readFile, realpath } from "node:fs/promises";
2
+ import { relative, resolve, sep } from "node:path";
3
+ import { resolvePortfolioAdapter } from "./adapters.js";
4
+ import { inspectPortfolioRegistry } from "./registry.js";
5
+ import { readPortfolioBenchmarkReport } from "./runner.js";
6
+ import { evaluateCrossProductTaxonomy } from "./taxonomy.js";
7
+ import { evaluateRuleCandidate } from "./promotion.js";
8
+ import { evaluateV3Qualification } from "./qualification.js";
9
+ import { verifyEvidenceReferences, verifyQualificationEvidenceSemantics, verifyRulePromotionEvidenceSemantics, } from "./evidence.js";
10
+ function requireEnabled() {
11
+ if (process.env.ZTOTHEZ_DESIGN_PORTFOLIO_MCP !== "enabled") {
12
+ throw new Error("Local portfolio MCP access is disabled. Set ZTOTHEZ_DESIGN_PORTFOLIO_MCP=enabled explicitly.");
13
+ }
14
+ }
15
+ function configuredPath(variable) {
16
+ const value = process.env[variable]?.trim();
17
+ if (!value)
18
+ throw new Error(`${variable} must be configured for local portfolio MCP access.`);
19
+ return resolve(value);
20
+ }
21
+ async function readConfiguredEvidenceFile(path) {
22
+ const root = await realpath(configuredPath("ZTOTHEZ_DESIGN_PORTFOLIO_EVIDENCE_ROOT"));
23
+ const candidate = await realpath(resolve(root, path));
24
+ const relation = relative(root, candidate);
25
+ if (relation === ".." || relation.startsWith(`..${sep}`)) {
26
+ throw new Error("The requested portfolio evidence file is outside the configured evidence root.");
27
+ }
28
+ return JSON.parse(await readFile(candidate, "utf8"));
29
+ }
30
+ export async function listPortfolioProjectsForMcp() {
31
+ requireEnabled();
32
+ const inspection = await inspectPortfolioRegistry(configuredPath("ZTOTHEZ_DESIGN_PORTFOLIO_REGISTRY"));
33
+ if (!inspection.report.passed)
34
+ throw new Error("The configured local portfolio registry is invalid.");
35
+ return {
36
+ version: "1.0.0",
37
+ registryId: inspection.registry.id,
38
+ projects: inspection.projects
39
+ .filter((project) => project.declaration.enabled)
40
+ .map((project) => {
41
+ const adapter = resolvePortfolioAdapter(project);
42
+ return {
43
+ id: project.declaration.id,
44
+ cohort: project.declaration.cohort,
45
+ archetype: project.declaration.product.archetype,
46
+ adapter: adapter.adapter?.id,
47
+ capabilities: adapter.capabilities.map((capability) => ({
48
+ stage: capability.stage,
49
+ status: capability.effectiveStatus,
50
+ })),
51
+ };
52
+ })
53
+ .sort((left, right) => left.id.localeCompare(right.id)),
54
+ };
55
+ }
56
+ export async function readPortfolioReportForMcp(runId, projectId) {
57
+ requireEnabled();
58
+ const report = await readPortfolioBenchmarkReport(configuredPath("ZTOTHEZ_DESIGN_PORTFOLIO_REPORT_ROOT"), runId);
59
+ const selected = projectId
60
+ ? report.projects.filter((project) => project.projectId === projectId)
61
+ : report.projects;
62
+ if (projectId && selected.length === 0)
63
+ throw new Error("The requested project is not present in this run.");
64
+ return {
65
+ version: "1.0.0",
66
+ runId: report.runId,
67
+ mode: report.mode,
68
+ cohort: report.cohort,
69
+ registryId: report.registryId,
70
+ toolVersion: report.toolVersion,
71
+ startedAt: report.startedAt,
72
+ completedAt: report.completedAt,
73
+ resultFingerprint: report.resultFingerprint,
74
+ passed: report.passed,
75
+ summary: report.summary,
76
+ projects: selected.map((project) => ({
77
+ projectId: project.projectId,
78
+ cohort: project.cohort,
79
+ adapter: project.adapter,
80
+ sourceDigest: project.sourceDigest,
81
+ sourceRevision: project.sourceRevision,
82
+ status: project.status,
83
+ stages: project.stages,
84
+ artifacts: project.artifacts,
85
+ })),
86
+ };
87
+ }
88
+ export async function getCrossProductEvaluationForMcp(runId) {
89
+ requireEnabled();
90
+ const report = await readPortfolioBenchmarkReport(configuredPath("ZTOTHEZ_DESIGN_PORTFOLIO_REPORT_ROOT"), runId);
91
+ const inspection = await inspectPortfolioRegistry(configuredPath("ZTOTHEZ_DESIGN_PORTFOLIO_REGISTRY"));
92
+ return evaluateCrossProductTaxonomy(report, inspection.projects);
93
+ }
94
+ export async function evaluateRulePromotionForMcp(candidatePath, evidencePath, devRunId, holdoutRunId) {
95
+ requireEnabled();
96
+ const candidateInput = await readConfiguredEvidenceFile(candidatePath);
97
+ const evidenceInput = await readConfiguredEvidenceFile(evidencePath);
98
+ const evidenceIntegrity = await verifyEvidenceReferences(configuredPath("ZTOTHEZ_DESIGN_PORTFOLIO_EVIDENCE_ROOT"), evidenceInput);
99
+ const inspection = await inspectPortfolioRegistry(configuredPath("ZTOTHEZ_DESIGN_PORTFOLIO_REGISTRY"));
100
+ const reportRoot = configuredPath("ZTOTHEZ_DESIGN_PORTFOLIO_REPORT_ROOT");
101
+ const devReport = devRunId ? await readPortfolioBenchmarkReport(reportRoot, devRunId) : undefined;
102
+ const holdoutReport = holdoutRunId ? await readPortfolioBenchmarkReport(reportRoot, holdoutRunId) : undefined;
103
+ const evidenceSemantics = await verifyRulePromotionEvidenceSemantics(configuredPath("ZTOTHEZ_DESIGN_PORTFOLIO_EVIDENCE_ROOT"), candidateInput, evidenceInput, holdoutReport);
104
+ return evaluateRuleCandidate(candidateInput, inspection, devReport, holdoutReport, evidenceInput, evidenceIntegrity.passed && evidenceSemantics.passed);
105
+ }
106
+ export async function evaluateV3QualificationForMcp(evidencePath, devRunId, holdoutRunId) {
107
+ requireEnabled();
108
+ const evidenceInput = await readConfiguredEvidenceFile(evidencePath);
109
+ const evidenceIntegrity = await verifyEvidenceReferences(configuredPath("ZTOTHEZ_DESIGN_PORTFOLIO_EVIDENCE_ROOT"), evidenceInput);
110
+ const inspection = await inspectPortfolioRegistry(configuredPath("ZTOTHEZ_DESIGN_PORTFOLIO_REGISTRY"));
111
+ const reportRoot = configuredPath("ZTOTHEZ_DESIGN_PORTFOLIO_REPORT_ROOT");
112
+ const devReport = devRunId ? await readPortfolioBenchmarkReport(reportRoot, devRunId) : undefined;
113
+ const holdoutReport = holdoutRunId ? await readPortfolioBenchmarkReport(reportRoot, holdoutRunId) : undefined;
114
+ const evidenceSemantics = await verifyQualificationEvidenceSemantics(configuredPath("ZTOTHEZ_DESIGN_PORTFOLIO_EVIDENCE_ROOT"), evidenceInput);
115
+ return evaluateV3Qualification(inspection, devReport, holdoutReport, evidenceInput, evidenceIntegrity.passed && evidenceSemantics.passed);
116
+ }
117
+ //# sourceMappingURL=mcp.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"mcp.js","sourceRoot":"","sources":["../../../src/portfolio/mcp.ts"],"names":[],"mappings":"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"}