@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,251 @@
1
+ import { z } from "zod";
2
+ export declare const portfolioRootClassSchema: z.ZodEnum<{
3
+ "studio-clients": "studio-clients";
4
+ "studio-fullstack": "studio-fullstack";
5
+ "studio-personal": "studio-personal";
6
+ "studio-portfolio": "studio-portfolio";
7
+ ai: "ai";
8
+ apps: "apps";
9
+ }>;
10
+ export declare const benchmarkStageSchema: z.ZodEnum<{
11
+ lint: "lint";
12
+ typecheck: "typecheck";
13
+ "unit-test": "unit-test";
14
+ "source-audit": "source-audit";
15
+ "production-build": "production-build";
16
+ "local-fixture-server": "local-fixture-server";
17
+ "browser-journeys": "browser-journeys";
18
+ "export-verification": "export-verification";
19
+ }>;
20
+ export declare const portfolioAdapterIdSchema: z.ZodEnum<{
21
+ "react-vite": "react-vite";
22
+ nextjs: "nextjs";
23
+ angular: "angular";
24
+ "static-web": "static-web";
25
+ "node-python-fullstack": "node-python-fullstack";
26
+ "python-source": "python-source";
27
+ }>;
28
+ export declare const portfolioRegistrySchema: z.ZodObject<{
29
+ version: z.ZodLiteral<"1.0">;
30
+ id: z.ZodString;
31
+ description: z.ZodString;
32
+ roots: z.ZodArray<z.ZodObject<{
33
+ id: z.ZodString;
34
+ class: z.ZodEnum<{
35
+ "studio-clients": "studio-clients";
36
+ "studio-fullstack": "studio-fullstack";
37
+ "studio-personal": "studio-personal";
38
+ "studio-portfolio": "studio-portfolio";
39
+ ai: "ai";
40
+ apps: "apps";
41
+ }>;
42
+ path: z.ZodString;
43
+ discoveryDepth: z.ZodDefault<z.ZodNumber>;
44
+ excludes: z.ZodDefault<z.ZodArray<z.ZodString>>;
45
+ }, z.core.$strict>>;
46
+ projects: z.ZodArray<z.ZodObject<{
47
+ id: z.ZodString;
48
+ root: z.ZodString;
49
+ path: z.ZodString;
50
+ enabled: z.ZodBoolean;
51
+ ownership: z.ZodEnum<{
52
+ unknown: "unknown";
53
+ "first-party": "first-party";
54
+ "client-authorized": "client-authorized";
55
+ "third-party-reference": "third-party-reference";
56
+ }>;
57
+ authorizationEvidence: z.ZodOptional<z.ZodString>;
58
+ confidentiality: z.ZodEnum<{
59
+ public: "public";
60
+ restricted: "restricted";
61
+ "private-local": "private-local";
62
+ }>;
63
+ cohort: z.ZodEnum<{
64
+ development: "development";
65
+ excluded: "excluded";
66
+ holdout: "holdout";
67
+ }>;
68
+ publication: z.ZodObject<{
69
+ sourceExcerpts: z.ZodBoolean;
70
+ screenshots: z.ZodBoolean;
71
+ machineReports: z.ZodBoolean;
72
+ aggregateMetrics: z.ZodBoolean;
73
+ }, z.core.$strict>;
74
+ product: z.ZodObject<{
75
+ domain: z.ZodString;
76
+ archetype: z.ZodEnum<{
77
+ "operational-dashboard": "operational-dashboard";
78
+ "ai-workspace": "ai-workspace";
79
+ "content-site": "content-site";
80
+ utility: "utility";
81
+ "full-stack-workflow": "full-stack-workflow";
82
+ other: "other";
83
+ }>;
84
+ intendedUsers: z.ZodArray<z.ZodString>;
85
+ primaryTasks: z.ZodArray<z.ZodString>;
86
+ }, z.core.$strict>;
87
+ technology: z.ZodObject<{
88
+ framework: z.ZodString;
89
+ packageManager: z.ZodEnum<{
90
+ none: "none";
91
+ other: "other";
92
+ npm: "npm";
93
+ pnpm: "pnpm";
94
+ yarn: "yarn";
95
+ bun: "bun";
96
+ pip: "pip";
97
+ poetry: "poetry";
98
+ }>;
99
+ entrypoint: z.ZodString;
100
+ adapter: z.ZodOptional<z.ZodEnum<{
101
+ "react-vite": "react-vite";
102
+ nextjs: "nextjs";
103
+ angular: "angular";
104
+ "static-web": "static-web";
105
+ "node-python-fullstack": "node-python-fullstack";
106
+ "python-source": "python-source";
107
+ }>>;
108
+ }, z.core.$strict>;
109
+ capabilities: z.ZodArray<z.ZodObject<{
110
+ stage: z.ZodEnum<{
111
+ lint: "lint";
112
+ typecheck: "typecheck";
113
+ "unit-test": "unit-test";
114
+ "source-audit": "source-audit";
115
+ "production-build": "production-build";
116
+ "local-fixture-server": "local-fixture-server";
117
+ "browser-journeys": "browser-journeys";
118
+ "export-verification": "export-verification";
119
+ }>;
120
+ status: z.ZodEnum<{
121
+ "not-applicable": "not-applicable";
122
+ supported: "supported";
123
+ unsupported: "unsupported";
124
+ }>;
125
+ reason: z.ZodString;
126
+ }, z.core.$strict>>;
127
+ execution: z.ZodObject<{
128
+ fixtureMode: z.ZodEnum<{
129
+ disconnected: "disconnected";
130
+ "not-applicable": "not-applicable";
131
+ "local-fixture": "local-fixture";
132
+ }>;
133
+ networkPolicy: z.ZodEnum<{
134
+ denied: "denied";
135
+ "dependency-install-only": "dependency-install-only";
136
+ }>;
137
+ lifecycleScripts: z.ZodBoolean;
138
+ allowedEnvironmentVariables: z.ZodDefault<z.ZodArray<z.ZodString>>;
139
+ localPorts: z.ZodDefault<z.ZodArray<z.ZodNumber>>;
140
+ commands: z.ZodDefault<z.ZodArray<z.ZodObject<{
141
+ stage: z.ZodEnum<{
142
+ lint: "lint";
143
+ typecheck: "typecheck";
144
+ "unit-test": "unit-test";
145
+ "source-audit": "source-audit";
146
+ "production-build": "production-build";
147
+ "local-fixture-server": "local-fixture-server";
148
+ "browser-journeys": "browser-journeys";
149
+ "export-verification": "export-verification";
150
+ }>;
151
+ command: z.ZodString;
152
+ arguments: z.ZodDefault<z.ZodArray<z.ZodString>>;
153
+ cwd: z.ZodDefault<z.ZodString>;
154
+ timeoutMs: z.ZodDefault<z.ZodNumber>;
155
+ maxOutputBytes: z.ZodDefault<z.ZodNumber>;
156
+ allowDependencyNetwork: z.ZodDefault<z.ZodBoolean>;
157
+ }, z.core.$strict>>>;
158
+ }, z.core.$strict>;
159
+ verification: z.ZodOptional<z.ZodObject<{
160
+ serveDirectory: z.ZodString;
161
+ port: z.ZodNumber;
162
+ route: z.ZodDefault<z.ZodString>;
163
+ readinessPath: z.ZodDefault<z.ZodString>;
164
+ contractPath: z.ZodString;
165
+ profile: z.ZodString;
166
+ attestationsPath: z.ZodOptional<z.ZodString>;
167
+ heuristicReviewPath: z.ZodOptional<z.ZodString>;
168
+ settleMs: z.ZodDefault<z.ZodNumber>;
169
+ }, z.core.$strict>>;
170
+ paths: z.ZodObject<{
171
+ include: z.ZodArray<z.ZodString>;
172
+ exclude: z.ZodDefault<z.ZodArray<z.ZodString>>;
173
+ }, z.core.$strict>;
174
+ source: z.ZodObject<{
175
+ revisionPolicy: z.ZodEnum<{
176
+ "capture-current": "capture-current";
177
+ "require-clean": "require-clean";
178
+ }>;
179
+ canonicalizationKey: z.ZodString;
180
+ }, z.core.$strict>;
181
+ }, z.core.$strict>>;
182
+ }, z.core.$strict>;
183
+ export declare const portfolioIssueSchema: z.ZodObject<{
184
+ code: z.ZodString;
185
+ severity: z.ZodEnum<{
186
+ error: "error";
187
+ warning: "warning";
188
+ }>;
189
+ path: z.ZodString;
190
+ message: z.ZodString;
191
+ }, z.core.$strict>;
192
+ export declare const portfolioRegistryReportSchema: z.ZodObject<{
193
+ version: z.ZodString;
194
+ generatedAt: z.ZodString;
195
+ registryId: z.ZodOptional<z.ZodString>;
196
+ counts: z.ZodObject<{
197
+ roots: z.ZodNumber;
198
+ projects: z.ZodNumber;
199
+ enabled: z.ZodNumber;
200
+ development: z.ZodNumber;
201
+ holdout: z.ZodNumber;
202
+ excluded: z.ZodNumber;
203
+ }, z.core.$strict>;
204
+ projects: z.ZodArray<z.ZodObject<{
205
+ id: z.ZodString;
206
+ root: z.ZodString;
207
+ rootClass: z.ZodOptional<z.ZodEnum<{
208
+ "studio-clients": "studio-clients";
209
+ "studio-fullstack": "studio-fullstack";
210
+ "studio-personal": "studio-personal";
211
+ "studio-portfolio": "studio-portfolio";
212
+ ai: "ai";
213
+ apps: "apps";
214
+ }>>;
215
+ enabled: z.ZodBoolean;
216
+ cohort: z.ZodEnum<{
217
+ development: "development";
218
+ excluded: "excluded";
219
+ holdout: "holdout";
220
+ }>;
221
+ ownership: z.ZodEnum<{
222
+ unknown: "unknown";
223
+ "first-party": "first-party";
224
+ "client-authorized": "client-authorized";
225
+ "third-party-reference": "third-party-reference";
226
+ }>;
227
+ confidentiality: z.ZodEnum<{
228
+ public: "public";
229
+ restricted: "restricted";
230
+ "private-local": "private-local";
231
+ }>;
232
+ resolved: z.ZodBoolean;
233
+ }, z.core.$strict>>;
234
+ issues: z.ZodArray<z.ZodObject<{
235
+ code: z.ZodString;
236
+ severity: z.ZodEnum<{
237
+ error: "error";
238
+ warning: "warning";
239
+ }>;
240
+ path: z.ZodString;
241
+ message: z.ZodString;
242
+ }, z.core.$strict>>;
243
+ passed: z.ZodBoolean;
244
+ }, z.core.$strict>;
245
+ export type PortfolioRegistry = z.infer<typeof portfolioRegistrySchema>;
246
+ export type PortfolioRoot = PortfolioRegistry["roots"][number];
247
+ export type PortfolioProject = PortfolioRegistry["projects"][number];
248
+ export type PortfolioAdapterId = z.infer<typeof portfolioAdapterIdSchema>;
249
+ export type BenchmarkStage = z.infer<typeof benchmarkStageSchema>;
250
+ export type PortfolioIssue = z.infer<typeof portfolioIssueSchema>;
251
+ export type PortfolioRegistryReport = z.infer<typeof portfolioRegistryReportSchema>;
@@ -0,0 +1,317 @@
1
+ import { z } from "zod";
2
+ const idSchema = z.string().regex(/^[a-z0-9][a-z0-9-]{0,63}$/);
3
+ const boundedText = (maximum) => z.string().trim().min(1).max(maximum);
4
+ const relativePatternSchema = boundedText(1_024).refine((value) => !value.includes("\0") &&
5
+ !value.startsWith("/") &&
6
+ !/^[A-Za-z]:[\\/]/.test(value) &&
7
+ !value.split(/[\\/]/).includes(".."), "Paths and patterns must remain relative and cannot contain parent traversal.");
8
+ const loopbackRouteSchema = boundedText(2_048).refine((value) => value.startsWith("/") && !value.includes("\0") && !value.startsWith("//"), "Loopback routes must start with one slash and cannot contain null bytes.");
9
+ export const portfolioRootClassSchema = z.enum([
10
+ "studio-clients",
11
+ "studio-fullstack",
12
+ "studio-personal",
13
+ "studio-portfolio",
14
+ "ai",
15
+ "apps",
16
+ ]);
17
+ export const benchmarkStageSchema = z.enum([
18
+ "source-audit",
19
+ "typecheck",
20
+ "lint",
21
+ "unit-test",
22
+ "production-build",
23
+ "local-fixture-server",
24
+ "browser-journeys",
25
+ "export-verification",
26
+ ]);
27
+ export const portfolioAdapterIdSchema = z.enum([
28
+ "react-vite",
29
+ "nextjs",
30
+ "angular",
31
+ "static-web",
32
+ "node-python-fullstack",
33
+ "python-source",
34
+ ]);
35
+ const publicationSchema = z
36
+ .object({
37
+ sourceExcerpts: z.boolean(),
38
+ screenshots: z.boolean(),
39
+ machineReports: z.boolean(),
40
+ aggregateMetrics: z.boolean(),
41
+ })
42
+ .strict();
43
+ const capabilitySchema = z
44
+ .object({
45
+ stage: benchmarkStageSchema,
46
+ status: z.enum(["supported", "unsupported", "not-applicable"]),
47
+ reason: boundedText(512),
48
+ })
49
+ .strict();
50
+ const adapterCommandSchema = z
51
+ .object({
52
+ stage: benchmarkStageSchema,
53
+ command: z.string().regex(/^[A-Za-z0-9][A-Za-z0-9._+-]{0,127}$/),
54
+ arguments: z
55
+ .array(boundedText(512).refine((value) => !value.includes("\0"), "Arguments cannot contain null bytes."))
56
+ .max(50)
57
+ .default([]),
58
+ cwd: relativePatternSchema.default("."),
59
+ timeoutMs: z.number().int().min(100).max(30 * 60_000).default(120_000),
60
+ maxOutputBytes: z.number().int().min(1_024).max(32 * 1024 * 1024).default(2 * 1024 * 1024),
61
+ allowDependencyNetwork: z.boolean().default(false),
62
+ })
63
+ .strict();
64
+ const rootSchema = z
65
+ .object({
66
+ id: idSchema,
67
+ class: portfolioRootClassSchema,
68
+ path: boundedText(4_096),
69
+ discoveryDepth: z.number().int().min(1).max(12).default(4),
70
+ excludes: z.array(relativePatternSchema).max(100).default([]),
71
+ })
72
+ .strict();
73
+ const projectSchema = z
74
+ .object({
75
+ id: idSchema,
76
+ root: idSchema,
77
+ path: relativePatternSchema,
78
+ enabled: z.boolean(),
79
+ ownership: z.enum([
80
+ "first-party",
81
+ "client-authorized",
82
+ "third-party-reference",
83
+ "unknown",
84
+ ]),
85
+ authorizationEvidence: boundedText(1_024).optional(),
86
+ confidentiality: z.enum(["public", "private-local", "restricted"]),
87
+ cohort: z.enum(["development", "holdout", "excluded"]),
88
+ publication: publicationSchema,
89
+ product: z
90
+ .object({
91
+ domain: boundedText(128),
92
+ archetype: z.enum([
93
+ "operational-dashboard",
94
+ "ai-workspace",
95
+ "content-site",
96
+ "utility",
97
+ "full-stack-workflow",
98
+ "other",
99
+ ]),
100
+ intendedUsers: z.array(boundedText(256)).min(1).max(20),
101
+ primaryTasks: z.array(boundedText(512)).min(1).max(20),
102
+ })
103
+ .strict(),
104
+ technology: z
105
+ .object({
106
+ framework: boundedText(128),
107
+ packageManager: z.enum(["npm", "pnpm", "yarn", "bun", "pip", "poetry", "none", "other"]),
108
+ entrypoint: relativePatternSchema,
109
+ adapter: portfolioAdapterIdSchema.optional(),
110
+ })
111
+ .strict(),
112
+ capabilities: z.array(capabilitySchema).min(1).max(benchmarkStageSchema.options.length),
113
+ execution: z
114
+ .object({
115
+ fixtureMode: z.enum(["local-fixture", "disconnected", "not-applicable"]),
116
+ networkPolicy: z.enum(["denied", "dependency-install-only"]),
117
+ lifecycleScripts: z.boolean(),
118
+ allowedEnvironmentVariables: z
119
+ .array(z.string().regex(/^[A-Z][A-Z0-9_]{0,127}$/))
120
+ .max(50)
121
+ .default([]),
122
+ localPorts: z.array(z.number().int().min(1).max(65_535)).max(20).default([]),
123
+ commands: z.array(adapterCommandSchema).max(benchmarkStageSchema.options.length).default([]),
124
+ })
125
+ .strict(),
126
+ verification: z
127
+ .object({
128
+ serveDirectory: relativePatternSchema,
129
+ port: z.number().int().min(1).max(65_535),
130
+ route: loopbackRouteSchema.default("/"),
131
+ readinessPath: loopbackRouteSchema.default("/"),
132
+ contractPath: relativePatternSchema,
133
+ profile: idSchema,
134
+ attestationsPath: relativePatternSchema.optional(),
135
+ heuristicReviewPath: relativePatternSchema.optional(),
136
+ settleMs: z.number().int().min(0).max(30_000).default(500),
137
+ })
138
+ .strict()
139
+ .optional(),
140
+ paths: z
141
+ .object({
142
+ include: z.array(relativePatternSchema).min(1).max(100),
143
+ exclude: z.array(relativePatternSchema).max(200).default([]),
144
+ })
145
+ .strict(),
146
+ source: z
147
+ .object({
148
+ revisionPolicy: z.enum(["capture-current", "require-clean"]),
149
+ canonicalizationKey: idSchema,
150
+ })
151
+ .strict(),
152
+ })
153
+ .strict()
154
+ .superRefine((project, context) => {
155
+ const stageNames = project.capabilities.map((capability) => capability.stage);
156
+ if (new Set(stageNames).size !== stageNames.length) {
157
+ context.addIssue({
158
+ code: "custom",
159
+ path: ["capabilities"],
160
+ message: "Capability stages must be unique within a project.",
161
+ });
162
+ }
163
+ if (project.enabled && project.cohort === "excluded") {
164
+ context.addIssue({
165
+ code: "custom",
166
+ path: ["cohort"],
167
+ message: "Enabled projects must belong to the development or holdout cohort.",
168
+ });
169
+ }
170
+ if (!project.enabled && project.cohort !== "excluded") {
171
+ context.addIssue({
172
+ code: "custom",
173
+ path: ["cohort"],
174
+ message: "Disabled projects must use the excluded cohort.",
175
+ });
176
+ }
177
+ if (project.ownership === "client-authorized" && !project.authorizationEvidence) {
178
+ context.addIssue({
179
+ code: "custom",
180
+ path: ["authorizationEvidence"],
181
+ message: "Client-authorized projects require an authorization evidence note.",
182
+ });
183
+ }
184
+ const commandStages = project.execution.commands.map((command) => command.stage);
185
+ if (new Set(commandStages).size !== commandStages.length) {
186
+ context.addIssue({
187
+ code: "custom",
188
+ path: ["execution", "commands"],
189
+ message: "Adapter command stages must be unique within a project.",
190
+ });
191
+ }
192
+ if (project.confidentiality === "restricted" &&
193
+ Object.values(project.publication).some(Boolean)) {
194
+ context.addIssue({
195
+ code: "custom",
196
+ path: ["publication"],
197
+ message: "Restricted projects cannot publish source, screenshots, reports, or aggregate metrics.",
198
+ });
199
+ }
200
+ if (project.verification) {
201
+ if (project.execution.fixtureMode !== "local-fixture") {
202
+ context.addIssue({
203
+ code: "custom",
204
+ path: ["execution", "fixtureMode"],
205
+ message: "Built-in browser verification requires local-fixture mode.",
206
+ });
207
+ }
208
+ if (!project.execution.localPorts.includes(project.verification.port)) {
209
+ context.addIssue({
210
+ code: "custom",
211
+ path: ["verification", "port"],
212
+ message: "The verification port must be declared in execution.localPorts.",
213
+ });
214
+ }
215
+ for (const stage of ["local-fixture-server", "browser-journeys"]) {
216
+ if (project.capabilities.find((entry) => entry.stage === stage)?.status !== "supported") {
217
+ context.addIssue({
218
+ code: "custom",
219
+ path: ["capabilities"],
220
+ message: `Built-in verification requires supported ${stage} capability.`,
221
+ });
222
+ }
223
+ }
224
+ }
225
+ });
226
+ export const portfolioRegistrySchema = z
227
+ .object({
228
+ version: z.literal("1.0"),
229
+ id: idSchema,
230
+ description: boundedText(1_024),
231
+ roots: z.array(rootSchema).min(1).max(20),
232
+ projects: z.array(projectSchema).max(500),
233
+ })
234
+ .strict()
235
+ .superRefine((registry, context) => {
236
+ const duplicateValues = (values) => {
237
+ const seen = new Set();
238
+ const duplicates = new Set();
239
+ for (const value of values) {
240
+ if (seen.has(value))
241
+ duplicates.add(value);
242
+ seen.add(value);
243
+ }
244
+ return duplicates;
245
+ };
246
+ for (const duplicate of duplicateValues(registry.roots.map((root) => root.id))) {
247
+ context.addIssue({ code: "custom", path: ["roots"], message: `Duplicate root ID: ${duplicate}.` });
248
+ }
249
+ for (const duplicate of duplicateValues(registry.roots.map((root) => root.class))) {
250
+ context.addIssue({ code: "custom", path: ["roots"], message: `Duplicate root class: ${duplicate}.` });
251
+ }
252
+ for (const duplicate of duplicateValues(registry.projects.map((project) => project.id))) {
253
+ context.addIssue({ code: "custom", path: ["projects"], message: `Duplicate project ID: ${duplicate}.` });
254
+ }
255
+ for (const duplicate of duplicateValues(registry.projects.map((project) => project.source.canonicalizationKey))) {
256
+ context.addIssue({
257
+ code: "custom",
258
+ path: ["projects"],
259
+ message: `Duplicate canonicalization key: ${duplicate}.`,
260
+ });
261
+ }
262
+ const rootIds = new Set(registry.roots.map((root) => root.id));
263
+ for (const [index, project] of registry.projects.entries()) {
264
+ if (!rootIds.has(project.root)) {
265
+ context.addIssue({
266
+ code: "custom",
267
+ path: ["projects", index, "root"],
268
+ message: `Unknown root: ${project.root}.`,
269
+ });
270
+ }
271
+ }
272
+ });
273
+ export const portfolioIssueSchema = z
274
+ .object({
275
+ code: z.string(),
276
+ severity: z.enum(["error", "warning"]),
277
+ path: z.string(),
278
+ message: z.string(),
279
+ })
280
+ .strict();
281
+ export const portfolioRegistryReportSchema = z
282
+ .object({
283
+ version: z.string(),
284
+ generatedAt: z.string(),
285
+ registryId: z.string().optional(),
286
+ counts: z
287
+ .object({
288
+ roots: z.number().int().nonnegative(),
289
+ projects: z.number().int().nonnegative(),
290
+ enabled: z.number().int().nonnegative(),
291
+ development: z.number().int().nonnegative(),
292
+ holdout: z.number().int().nonnegative(),
293
+ excluded: z.number().int().nonnegative(),
294
+ })
295
+ .strict(),
296
+ projects: z.array(z
297
+ .object({
298
+ id: z.string(),
299
+ root: z.string(),
300
+ rootClass: portfolioRootClassSchema.optional(),
301
+ enabled: z.boolean(),
302
+ cohort: z.enum(["development", "holdout", "excluded"]),
303
+ ownership: z.enum([
304
+ "first-party",
305
+ "client-authorized",
306
+ "third-party-reference",
307
+ "unknown",
308
+ ]),
309
+ confidentiality: z.enum(["public", "private-local", "restricted"]),
310
+ resolved: z.boolean(),
311
+ })
312
+ .strict()),
313
+ issues: z.array(portfolioIssueSchema),
314
+ passed: z.boolean(),
315
+ })
316
+ .strict();
317
+ //# sourceMappingURL=schema.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"schema.js","sourceRoot":"","sources":["../../../src/portfolio/schema.ts"],"names":[],"mappings":"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"}
@@ -0,0 +1,89 @@
1
+ import type { ResolvedPortfolioProject } from "./registry.js";
2
+ export type SourceManifestEntry = {
3
+ path: string;
4
+ type: "directory" | "file" | "symlink" | "other";
5
+ scope: "copy" | "guard";
6
+ size: number;
7
+ mode: number;
8
+ modifiedAtMs: number;
9
+ sha256?: string;
10
+ linkTarget?: string;
11
+ resolvedLinkPath?: string;
12
+ };
13
+ export type GitSourceState = {
14
+ head: string;
15
+ status: string;
16
+ statusSha256: string;
17
+ };
18
+ export type SourceState = {
19
+ version: string;
20
+ generatedAt: string;
21
+ projectId: string;
22
+ entries: SourceManifestEntry[];
23
+ git?: GitSourceState;
24
+ digest: string;
25
+ };
26
+ export type SourceStateDifference = {
27
+ path: string;
28
+ change: "added" | "removed" | "modified" | "git-status";
29
+ };
30
+ export type SnapshotPolicy = {
31
+ maxFiles?: number;
32
+ maxHashedBytes?: number;
33
+ };
34
+ export type PortfolioSnapshot = {
35
+ project: ResolvedPortfolioProject;
36
+ snapshotRoot: string;
37
+ sourceState: SourceState;
38
+ copiedFiles: number;
39
+ copiedBytes: number;
40
+ };
41
+ export type SnapshotSummary = {
42
+ version: string;
43
+ projectId: string;
44
+ sourceDigest: string;
45
+ sourceEntries: number;
46
+ copiedFiles: number;
47
+ copiedBytes: number;
48
+ snapshotRoot?: string;
49
+ sourceUnchanged: boolean;
50
+ };
51
+ export type SnapshotProcessOptions = {
52
+ command: string;
53
+ arguments?: string[];
54
+ cwd?: string;
55
+ environment?: Record<string, string>;
56
+ timeoutMs?: number;
57
+ maxOutputBytes?: number;
58
+ allowDependencyNetwork?: boolean;
59
+ };
60
+ export type SnapshotProcessResult = {
61
+ version: string;
62
+ command: string;
63
+ exitCode: number | null;
64
+ signal: NodeJS.Signals | null;
65
+ timedOut: boolean;
66
+ durationMs: number;
67
+ stdout: string;
68
+ stderr: string;
69
+ outputTruncated: boolean;
70
+ network: "denied" | "dependency-install-only";
71
+ sourceUnchanged: boolean;
72
+ };
73
+ export declare class SourceMutationError extends Error {
74
+ readonly differences: SourceStateDifference[];
75
+ constructor(differences: SourceStateDifference[]);
76
+ }
77
+ export declare function captureSourceState(project: ResolvedPortfolioProject, policy?: SnapshotPolicy): Promise<SourceState>;
78
+ export declare function compareSourceStates(before: SourceState, after: SourceState): SourceStateDifference[];
79
+ export declare function createPortfolioSnapshot(project: ResolvedPortfolioProject, workspaceRoot: string, policy?: SnapshotPolicy): Promise<PortfolioSnapshot>;
80
+ export declare function verifyPortfolioSourceUnchanged(snapshot: PortfolioSnapshot, policy?: SnapshotPolicy): Promise<SourceStateDifference[]>;
81
+ export declare function closePortfolioSnapshot(snapshot: PortfolioSnapshot, options?: {
82
+ keep?: boolean;
83
+ policy?: SnapshotPolicy;
84
+ }): Promise<SnapshotSummary>;
85
+ export declare function withPortfolioSnapshot<T>(project: ResolvedPortfolioProject, workspaceRoot: string, operation: (snapshot: PortfolioSnapshot) => Promise<T>, policy?: SnapshotPolicy): Promise<{
86
+ result: T;
87
+ summary: SnapshotSummary;
88
+ }>;
89
+ export declare function runPortfolioSnapshotProcess(snapshot: PortfolioSnapshot, options: SnapshotProcessOptions): Promise<SnapshotProcessResult>;