@cbnventures/nova 0.19.0 → 0.21.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 (536) hide show
  1. package/README.md +10 -0
  2. package/bin/nova.mjs +3 -3
  3. package/build/package.json +14 -10
  4. package/build/src/cli/generate/github/funding.js +2 -2
  5. package/build/src/cli/generate/github/funding.js.map +1 -1
  6. package/build/src/cli/generate/github/issue-template.d.ts.map +1 -1
  7. package/build/src/cli/generate/github/issue-template.js +6 -95
  8. package/build/src/cli/generate/github/issue-template.js.map +1 -1
  9. package/build/src/cli/generate/github/workflows-blueprint-validate.d.ts +12 -0
  10. package/build/src/cli/generate/github/workflows-blueprint-validate.d.ts.map +1 -0
  11. package/build/src/cli/generate/github/workflows-blueprint-validate.js +535 -0
  12. package/build/src/cli/generate/github/workflows-blueprint-validate.js.map +1 -0
  13. package/build/src/cli/generate/github/workflows-blueprint-variables.d.ts +9 -0
  14. package/build/src/cli/generate/github/workflows-blueprint-variables.d.ts.map +1 -0
  15. package/build/src/cli/generate/github/workflows-blueprint-variables.js +117 -0
  16. package/build/src/cli/generate/github/workflows-blueprint-variables.js.map +1 -0
  17. package/build/src/cli/generate/github/workflows-blueprint.d.ts +60 -0
  18. package/build/src/cli/generate/github/workflows-blueprint.d.ts.map +1 -0
  19. package/build/src/cli/generate/github/workflows-blueprint.js +2251 -0
  20. package/build/src/cli/generate/github/workflows-blueprint.js.map +1 -0
  21. package/build/src/cli/generate/must-haves/agent-conventions.d.ts.map +1 -1
  22. package/build/src/cli/generate/must-haves/agent-conventions.js +14 -5
  23. package/build/src/cli/generate/must-haves/agent-conventions.js.map +1 -1
  24. package/build/src/cli/generate/must-haves/dotenv.d.ts +5 -7
  25. package/build/src/cli/generate/must-haves/dotenv.d.ts.map +1 -1
  26. package/build/src/cli/generate/must-haves/dotenv.js +146 -417
  27. package/build/src/cli/generate/must-haves/dotenv.js.map +1 -1
  28. package/build/src/cli/generate/must-haves/editorconfig.js +2 -2
  29. package/build/src/cli/generate/must-haves/editorconfig.js.map +1 -1
  30. package/build/src/cli/generate/must-haves/gitignore.d.ts +0 -8
  31. package/build/src/cli/generate/must-haves/gitignore.d.ts.map +1 -1
  32. package/build/src/cli/generate/must-haves/gitignore.js +9 -397
  33. package/build/src/cli/generate/must-haves/gitignore.js.map +1 -1
  34. package/build/src/cli/generate/must-haves/license.d.ts.map +1 -1
  35. package/build/src/cli/generate/must-haves/license.js +4 -4
  36. package/build/src/cli/generate/must-haves/license.js.map +1 -1
  37. package/build/src/cli/generate/must-haves/read-me.d.ts +6 -2
  38. package/build/src/cli/generate/must-haves/read-me.d.ts.map +1 -1
  39. package/build/src/cli/generate/must-haves/read-me.js +103 -63
  40. package/build/src/cli/generate/must-haves/read-me.js.map +1 -1
  41. package/build/src/cli/index.js +108 -2
  42. package/build/src/cli/index.js.map +1 -1
  43. package/build/src/cli/recipe/github/sync-features.d.ts.map +1 -1
  44. package/build/src/cli/recipe/github/sync-features.js +5 -3
  45. package/build/src/cli/recipe/github/sync-features.js.map +1 -1
  46. package/build/src/cli/recipe/github/sync-identity.d.ts.map +1 -1
  47. package/build/src/cli/recipe/github/sync-identity.js +6 -4
  48. package/build/src/cli/recipe/github/sync-identity.js.map +1 -1
  49. package/build/src/cli/recipe/github/sync-policies.d.ts.map +1 -1
  50. package/build/src/cli/recipe/github/sync-policies.js +13 -4
  51. package/build/src/cli/recipe/github/sync-policies.js.map +1 -1
  52. package/build/src/cli/recipe/index.d.ts.map +1 -1
  53. package/build/src/cli/recipe/index.js +32 -0
  54. package/build/src/cli/recipe/index.js.map +1 -1
  55. package/build/src/cli/recipe/license/update-copyright.d.ts +7 -0
  56. package/build/src/cli/recipe/license/update-copyright.d.ts.map +1 -0
  57. package/build/src/cli/recipe/license/update-copyright.js +191 -0
  58. package/build/src/cli/recipe/license/update-copyright.js.map +1 -0
  59. package/build/src/cli/recipe/package-json/cleanup.d.ts.map +1 -1
  60. package/build/src/cli/recipe/package-json/cleanup.js +14 -13
  61. package/build/src/cli/recipe/package-json/cleanup.js.map +1 -1
  62. package/build/src/cli/recipe/package-json/normalize-artifacts.d.ts.map +1 -1
  63. package/build/src/cli/recipe/package-json/normalize-artifacts.js +11 -6
  64. package/build/src/cli/recipe/package-json/normalize-artifacts.js.map +1 -1
  65. package/build/src/cli/recipe/package-json/normalize-bundler.d.ts.map +1 -1
  66. package/build/src/cli/recipe/package-json/normalize-bundler.js +11 -6
  67. package/build/src/cli/recipe/package-json/normalize-bundler.js.map +1 -1
  68. package/build/src/cli/recipe/package-json/normalize-dependencies.d.ts.map +1 -1
  69. package/build/src/cli/recipe/package-json/normalize-dependencies.js +18 -10
  70. package/build/src/cli/recipe/package-json/normalize-dependencies.js.map +1 -1
  71. package/build/src/cli/recipe/package-json/normalize-modules.d.ts.map +1 -1
  72. package/build/src/cli/recipe/package-json/normalize-modules.js +11 -6
  73. package/build/src/cli/recipe/package-json/normalize-modules.js.map +1 -1
  74. package/build/src/cli/recipe/package-json/normalize-tooling.d.ts.map +1 -1
  75. package/build/src/cli/recipe/package-json/normalize-tooling.js +12 -7
  76. package/build/src/cli/recipe/package-json/normalize-tooling.js.map +1 -1
  77. package/build/src/cli/recipe/package-json/sync-environment.d.ts.map +1 -1
  78. package/build/src/cli/recipe/package-json/sync-environment.js +46 -14
  79. package/build/src/cli/recipe/package-json/sync-environment.js.map +1 -1
  80. package/build/src/cli/recipe/package-json/sync-identity.d.ts.map +1 -1
  81. package/build/src/cli/recipe/package-json/sync-identity.js +29 -16
  82. package/build/src/cli/recipe/package-json/sync-identity.js.map +1 -1
  83. package/build/src/cli/recipe/package-json/sync-ownership.d.ts.map +1 -1
  84. package/build/src/cli/recipe/package-json/sync-ownership.js +18 -11
  85. package/build/src/cli/recipe/package-json/sync-ownership.js.map +1 -1
  86. package/build/src/cli/recipe/read-me/update-badges.d.ts +6 -0
  87. package/build/src/cli/recipe/read-me/update-badges.d.ts.map +1 -0
  88. package/build/src/cli/recipe/read-me/update-badges.js +115 -0
  89. package/build/src/cli/recipe/read-me/update-badges.js.map +1 -0
  90. package/build/src/cli/recipe/read-me/update-credits.d.ts +6 -0
  91. package/build/src/cli/recipe/read-me/update-credits.d.ts.map +1 -0
  92. package/build/src/cli/recipe/read-me/update-credits.js +115 -0
  93. package/build/src/cli/recipe/read-me/update-credits.js.map +1 -0
  94. package/build/src/cli/recipe/read-me/update-documentation.d.ts +6 -0
  95. package/build/src/cli/recipe/read-me/update-documentation.d.ts.map +1 -0
  96. package/build/src/cli/recipe/read-me/update-documentation.js +115 -0
  97. package/build/src/cli/recipe/read-me/update-documentation.js.map +1 -0
  98. package/build/src/cli/recipe/read-me/update-header.d.ts +6 -0
  99. package/build/src/cli/recipe/read-me/update-header.d.ts.map +1 -0
  100. package/build/src/cli/recipe/read-me/update-header.js +115 -0
  101. package/build/src/cli/recipe/read-me/update-header.js.map +1 -0
  102. package/build/src/cli/recipe/read-me/update-introduction.d.ts +6 -0
  103. package/build/src/cli/recipe/read-me/update-introduction.d.ts.map +1 -0
  104. package/build/src/cli/recipe/read-me/update-introduction.js +115 -0
  105. package/build/src/cli/recipe/read-me/update-introduction.js.map +1 -0
  106. package/build/src/cli/scaffold/starter/base.js +1 -1
  107. package/build/src/cli/scaffold/starter/base.js.map +1 -1
  108. package/build/src/cli/utility/changelog.d.ts +2 -0
  109. package/build/src/cli/utility/changelog.d.ts.map +1 -1
  110. package/build/src/cli/utility/changelog.js +159 -3
  111. package/build/src/cli/utility/changelog.js.map +1 -1
  112. package/build/src/cli/utility/initialize.d.ts +9 -0
  113. package/build/src/cli/utility/initialize.d.ts.map +1 -1
  114. package/build/src/cli/utility/initialize.js +978 -111
  115. package/build/src/cli/utility/initialize.js.map +1 -1
  116. package/build/src/cli/utility/run-scripts.d.ts.map +1 -1
  117. package/build/src/cli/utility/run-scripts.js +4 -4
  118. package/build/src/cli/utility/run-scripts.js.map +1 -1
  119. package/build/src/cli/utility/transpile.js +1 -1
  120. package/build/src/cli/utility/transpile.js.map +1 -1
  121. package/build/src/cli/utility/type-check.js +1 -1
  122. package/build/src/cli/utility/type-check.js.map +1 -1
  123. package/build/src/cli/utility/version.js +1 -1
  124. package/build/src/cli/utility/version.js.map +1 -1
  125. package/build/src/lib/dotenv.d.ts +3 -0
  126. package/build/src/lib/dotenv.d.ts.map +1 -0
  127. package/build/src/lib/dotenv.js +66 -0
  128. package/build/src/lib/dotenv.js.map +1 -0
  129. package/build/src/lib/env-github.d.ts +4 -0
  130. package/build/src/lib/env-github.d.ts.map +1 -0
  131. package/build/src/lib/env-github.js +57 -0
  132. package/build/src/lib/env-github.js.map +1 -0
  133. package/build/src/lib/env-managed-set.d.ts +3 -0
  134. package/build/src/lib/env-managed-set.d.ts.map +1 -0
  135. package/build/src/lib/env-managed-set.js +102 -0
  136. package/build/src/lib/env-managed-set.js.map +1 -0
  137. package/build/src/lib/env-namespace.d.ts +3 -0
  138. package/build/src/lib/env-namespace.d.ts.map +1 -0
  139. package/build/src/lib/env-namespace.js +11 -0
  140. package/build/src/lib/env-namespace.js.map +1 -0
  141. package/build/src/lib/env-reconcile.d.ts +3 -0
  142. package/build/src/lib/env-reconcile.d.ts.map +1 -0
  143. package/build/src/lib/env-reconcile.js +109 -0
  144. package/build/src/lib/env-reconcile.js.map +1 -0
  145. package/build/src/lib/env-status.d.ts +3 -0
  146. package/build/src/lib/env-status.d.ts.map +1 -0
  147. package/build/src/lib/env-status.js +113 -0
  148. package/build/src/lib/env-status.js.map +1 -0
  149. package/build/src/lib/file-discovery.d.ts +3 -0
  150. package/build/src/lib/file-discovery.d.ts.map +1 -0
  151. package/build/src/lib/file-discovery.js +32 -0
  152. package/build/src/lib/file-discovery.js.map +1 -0
  153. package/build/src/lib/item.d.ts +4 -1
  154. package/build/src/lib/item.d.ts.map +1 -1
  155. package/build/src/lib/item.js +35 -0
  156. package/build/src/lib/item.js.map +1 -1
  157. package/build/src/lib/markdown-slug.d.ts +4 -0
  158. package/build/src/lib/markdown-slug.d.ts.map +1 -0
  159. package/build/src/lib/markdown-slug.js +25 -0
  160. package/build/src/lib/markdown-slug.js.map +1 -0
  161. package/build/src/lib/nova-config.d.ts +14 -2
  162. package/build/src/lib/nova-config.d.ts.map +1 -1
  163. package/build/src/lib/nova-config.js +507 -78
  164. package/build/src/lib/nova-config.js.map +1 -1
  165. package/build/src/lib/read-me-regions.d.ts +4 -0
  166. package/build/src/lib/read-me-regions.d.ts.map +1 -0
  167. package/build/src/lib/read-me-regions.js +33 -0
  168. package/build/src/lib/read-me-regions.js.map +1 -0
  169. package/build/src/lib/regex.d.ts +73 -0
  170. package/build/src/lib/regex.d.ts.map +1 -1
  171. package/build/src/lib/regex.js +75 -2
  172. package/build/src/lib/regex.js.map +1 -1
  173. package/build/src/lib/scaffold.d.ts.map +1 -1
  174. package/build/src/lib/scaffold.js +33 -14
  175. package/build/src/lib/scaffold.js.map +1 -1
  176. package/build/src/lib/type-declaration-engine.d.ts +32 -0
  177. package/build/src/lib/type-declaration-engine.d.ts.map +1 -0
  178. package/build/src/lib/type-declaration-engine.js +796 -0
  179. package/build/src/lib/type-declaration-engine.js.map +1 -0
  180. package/build/src/lib/utility.d.ts +2 -1
  181. package/build/src/lib/utility.d.ts.map +1 -1
  182. package/build/src/lib/utility.js +47 -15
  183. package/build/src/lib/utility.js.map +1 -1
  184. package/build/src/lib/workflow-templates.d.ts.map +1 -1
  185. package/build/src/lib/workflow-templates.js +86 -60
  186. package/build/src/lib/workflow-templates.js.map +1 -1
  187. package/build/src/presets/eslint/dx-code-style.d.ts.map +1 -1
  188. package/build/src/presets/eslint/dx-code-style.js +6 -0
  189. package/build/src/presets/eslint/dx-code-style.js.map +1 -1
  190. package/build/src/presets/eslint/fw-astro.d.ts +4 -0
  191. package/build/src/presets/eslint/fw-astro.d.ts.map +1 -0
  192. package/build/src/presets/eslint/fw-astro.js +13 -0
  193. package/build/src/presets/eslint/fw-astro.js.map +1 -0
  194. package/build/src/presets/eslint/index.d.ts +1 -0
  195. package/build/src/presets/eslint/index.d.ts.map +1 -1
  196. package/build/src/presets/eslint/index.js +1 -0
  197. package/build/src/presets/eslint/index.js.map +1 -1
  198. package/build/src/presets/tsconfig/fw-astro.json +15 -0
  199. package/build/src/rules/eslint/conventions/no-implicit-boolean.d.ts.map +1 -1
  200. package/build/src/rules/eslint/conventions/no-implicit-boolean.js +3 -2
  201. package/build/src/rules/eslint/conventions/no-implicit-boolean.js.map +1 -1
  202. package/build/src/rules/eslint/conventions/require-hash-private.js +1 -1
  203. package/build/src/rules/eslint/conventions/require-hash-private.js.map +1 -1
  204. package/build/src/rules/eslint/conventions/require-kebab-case-filename.d.ts.map +1 -1
  205. package/build/src/rules/eslint/conventions/require-kebab-case-filename.js +4 -1
  206. package/build/src/rules/eslint/conventions/require-kebab-case-filename.js.map +1 -1
  207. package/build/src/rules/eslint/conventions/require-node-protocol.d.ts +11 -0
  208. package/build/src/rules/eslint/conventions/require-node-protocol.d.ts.map +1 -0
  209. package/build/src/rules/eslint/conventions/require-node-protocol.js +76 -0
  210. package/build/src/rules/eslint/conventions/require-node-protocol.js.map +1 -0
  211. package/build/src/rules/eslint/formatting/no-raw-text-in-code.d.ts.map +1 -1
  212. package/build/src/rules/eslint/formatting/no-raw-text-in-code.js +2 -1
  213. package/build/src/rules/eslint/formatting/no-raw-text-in-code.js.map +1 -1
  214. package/build/src/rules/eslint/formatting/require-padding-lines.d.ts.map +1 -1
  215. package/build/src/rules/eslint/formatting/require-padding-lines.js +7 -3
  216. package/build/src/rules/eslint/formatting/require-padding-lines.js.map +1 -1
  217. package/build/src/rules/eslint/formatting/require-ternary-parens.d.ts.map +1 -1
  218. package/build/src/rules/eslint/formatting/require-ternary-parens.js +7 -17
  219. package/build/src/rules/eslint/formatting/require-ternary-parens.js.map +1 -1
  220. package/build/src/rules/eslint/index.d.ts +4 -0
  221. package/build/src/rules/eslint/index.d.ts.map +1 -1
  222. package/build/src/rules/eslint/index.js +4 -0
  223. package/build/src/rules/eslint/index.js.map +1 -1
  224. package/build/src/rules/eslint/jsdoc/require-jsdoc-body.d.ts +3 -2
  225. package/build/src/rules/eslint/jsdoc/require-jsdoc-body.d.ts.map +1 -1
  226. package/build/src/rules/eslint/jsdoc/require-jsdoc-body.js +22 -0
  227. package/build/src/rules/eslint/jsdoc/require-jsdoc-body.js.map +1 -1
  228. package/build/src/rules/eslint/jsdoc/require-jsdoc-hierarchy.d.ts +2 -1
  229. package/build/src/rules/eslint/jsdoc/require-jsdoc-hierarchy.d.ts.map +1 -1
  230. package/build/src/rules/eslint/jsdoc/require-jsdoc-hierarchy.js +19 -4
  231. package/build/src/rules/eslint/jsdoc/require-jsdoc-hierarchy.js.map +1 -1
  232. package/build/src/rules/eslint/jsdoc/require-jsdoc-param-alignment.d.ts.map +1 -1
  233. package/build/src/rules/eslint/jsdoc/require-jsdoc-param-alignment.js +3 -2
  234. package/build/src/rules/eslint/jsdoc/require-jsdoc-param-alignment.js.map +1 -1
  235. package/build/src/rules/eslint/jsdoc/require-jsdoc-param-name.d.ts.map +1 -1
  236. package/build/src/rules/eslint/jsdoc/require-jsdoc-param-name.js +10 -6
  237. package/build/src/rules/eslint/jsdoc/require-jsdoc-param-name.js.map +1 -1
  238. package/build/src/rules/eslint/jsdoc/require-jsdoc-presence.d.ts +12 -0
  239. package/build/src/rules/eslint/jsdoc/require-jsdoc-presence.d.ts.map +1 -0
  240. package/build/src/rules/eslint/jsdoc/require-jsdoc-presence.js +169 -0
  241. package/build/src/rules/eslint/jsdoc/require-jsdoc-presence.js.map +1 -0
  242. package/build/src/rules/eslint/jsdoc/require-jsdoc-returns.d.ts +11 -0
  243. package/build/src/rules/eslint/jsdoc/require-jsdoc-returns.d.ts.map +1 -0
  244. package/build/src/rules/eslint/jsdoc/require-jsdoc-returns.js +80 -0
  245. package/build/src/rules/eslint/jsdoc/require-jsdoc-returns.js.map +1 -0
  246. package/build/src/rules/eslint/jsdoc/require-jsdoc-since.d.ts +1 -1
  247. package/build/src/rules/eslint/jsdoc/require-jsdoc-since.d.ts.map +1 -1
  248. package/build/src/rules/eslint/jsdoc/require-jsdoc-since.js +102 -6
  249. package/build/src/rules/eslint/jsdoc/require-jsdoc-since.js.map +1 -1
  250. package/build/src/rules/eslint/jsdoc/require-jsdoc-tag-order.d.ts +15 -0
  251. package/build/src/rules/eslint/jsdoc/require-jsdoc-tag-order.d.ts.map +1 -0
  252. package/build/src/rules/eslint/jsdoc/require-jsdoc-tag-order.js +290 -0
  253. package/build/src/rules/eslint/jsdoc/require-jsdoc-tag-order.js.map +1 -0
  254. package/build/src/rules/eslint/patterns/no-await-in-loop.js +1 -1
  255. package/build/src/rules/eslint/patterns/no-await-in-loop.js.map +1 -1
  256. package/build/src/rules/eslint/patterns/no-bracket-method-call.d.ts.map +1 -1
  257. package/build/src/rules/eslint/patterns/no-bracket-method-call.js +4 -0
  258. package/build/src/rules/eslint/patterns/no-bracket-method-call.js.map +1 -1
  259. package/build/src/rules/eslint/regex/no-regex-literals.d.ts +1 -0
  260. package/build/src/rules/eslint/regex/no-regex-literals.d.ts.map +1 -1
  261. package/build/src/rules/eslint/regex/no-regex-literals.js +39 -1
  262. package/build/src/rules/eslint/regex/no-regex-literals.js.map +1 -1
  263. package/build/src/rules/eslint/typescript/no-inline-type-annotation.d.ts.map +1 -1
  264. package/build/src/rules/eslint/typescript/no-inline-type-annotation.js +4 -1
  265. package/build/src/rules/eslint/typescript/no-inline-type-annotation.js.map +1 -1
  266. package/build/src/rules/eslint/typescript/require-bracket-property-access.d.ts.map +1 -1
  267. package/build/src/rules/eslint/typescript/require-bracket-property-access.js +8 -1
  268. package/build/src/rules/eslint/typescript/require-bracket-property-access.js.map +1 -1
  269. package/build/src/rules/eslint/typescript/require-type-naming.js +2 -2
  270. package/build/src/rules/eslint/typescript/require-type-naming.js.map +1 -1
  271. package/build/src/rules/vitest/active-vitest.d.ts +5 -0
  272. package/build/src/rules/vitest/active-vitest.d.ts.map +1 -0
  273. package/build/src/rules/vitest/active-vitest.js +19 -0
  274. package/build/src/rules/vitest/active-vitest.js.map +1 -0
  275. package/build/src/rules/vitest/dotenv/register.d.ts +3 -0
  276. package/build/src/rules/vitest/dotenv/register.d.ts.map +1 -0
  277. package/build/src/rules/vitest/dotenv/register.js +22 -0
  278. package/build/src/rules/vitest/dotenv/register.js.map +1 -0
  279. package/build/src/rules/vitest/dotenv/rules.d.ts +3 -0
  280. package/build/src/rules/vitest/dotenv/rules.d.ts.map +1 -0
  281. package/build/src/rules/vitest/dotenv/rules.js +32 -0
  282. package/build/src/rules/vitest/dotenv/rules.js.map +1 -0
  283. package/build/src/rules/vitest/enable.d.ts +3 -0
  284. package/build/src/rules/vitest/enable.d.ts.map +1 -0
  285. package/build/src/rules/vitest/enable.js +7 -0
  286. package/build/src/rules/vitest/enable.js.map +1 -0
  287. package/build/src/rules/vitest/frontmatter/register.d.ts +3 -0
  288. package/build/src/rules/vitest/frontmatter/register.d.ts.map +1 -0
  289. package/build/src/rules/vitest/frontmatter/register.js +52 -0
  290. package/build/src/rules/vitest/frontmatter/register.js.map +1 -0
  291. package/build/src/rules/vitest/frontmatter/rules.d.ts +15 -0
  292. package/build/src/rules/vitest/frontmatter/rules.d.ts.map +1 -0
  293. package/build/src/rules/vitest/frontmatter/rules.js +498 -0
  294. package/build/src/rules/vitest/frontmatter/rules.js.map +1 -0
  295. package/build/src/rules/vitest/index.d.ts +8 -0
  296. package/build/src/rules/vitest/index.d.ts.map +1 -0
  297. package/build/src/rules/vitest/index.js +7 -0
  298. package/build/src/rules/vitest/index.js.map +1 -0
  299. package/build/src/rules/vitest/link/register.d.ts +3 -0
  300. package/build/src/rules/vitest/link/register.d.ts.map +1 -0
  301. package/build/src/rules/vitest/link/register.js +44 -0
  302. package/build/src/rules/vitest/link/register.js.map +1 -0
  303. package/build/src/rules/vitest/link/rules.d.ts +12 -0
  304. package/build/src/rules/vitest/link/rules.d.ts.map +1 -0
  305. package/build/src/rules/vitest/link/rules.js +313 -0
  306. package/build/src/rules/vitest/link/rules.js.map +1 -0
  307. package/build/src/rules/vitest/markdown-table/register.d.ts +3 -0
  308. package/build/src/rules/vitest/markdown-table/register.d.ts.map +1 -0
  309. package/build/src/rules/vitest/markdown-table/register.js +26 -0
  310. package/build/src/rules/vitest/markdown-table/register.js.map +1 -0
  311. package/build/src/rules/vitest/markdown-table/rules.d.ts +3 -0
  312. package/build/src/rules/vitest/markdown-table/rules.d.ts.map +1 -0
  313. package/build/src/rules/vitest/markdown-table/rules.js +99 -0
  314. package/build/src/rules/vitest/markdown-table/rules.js.map +1 -0
  315. package/build/src/rules/vitest/terminology/register.d.ts +3 -0
  316. package/build/src/rules/vitest/terminology/register.d.ts.map +1 -0
  317. package/build/src/rules/vitest/terminology/register.js +39 -0
  318. package/build/src/rules/vitest/terminology/register.js.map +1 -0
  319. package/build/src/rules/vitest/terminology/rules.d.ts +10 -0
  320. package/build/src/rules/vitest/terminology/rules.d.ts.map +1 -0
  321. package/build/src/rules/vitest/terminology/rules.js +202 -0
  322. package/build/src/rules/vitest/terminology/rules.js.map +1 -0
  323. package/build/src/rules/vitest/type-declarations/register.d.ts +3 -0
  324. package/build/src/rules/vitest/type-declarations/register.d.ts.map +1 -0
  325. package/build/src/rules/vitest/type-declarations/register.js +33 -0
  326. package/build/src/rules/vitest/type-declarations/register.js.map +1 -0
  327. package/build/src/rules/vitest/type-declarations/rules.d.ts +13 -0
  328. package/build/src/rules/vitest/type-declarations/rules.d.ts.map +1 -0
  329. package/build/src/rules/vitest/type-declarations/rules.js +736 -0
  330. package/build/src/rules/vitest/type-declarations/rules.js.map +1 -0
  331. package/build/src/toolkit/index.d.ts +1 -0
  332. package/build/src/toolkit/index.d.ts.map +1 -1
  333. package/build/src/toolkit/index.js +1 -0
  334. package/build/src/toolkit/index.js.map +1 -1
  335. package/build/src/toolkit/logger.d.ts.map +1 -1
  336. package/build/src/toolkit/logger.js +3 -1
  337. package/build/src/toolkit/logger.js.map +1 -1
  338. package/build/src/toolkit/markdown-table.js +1 -1
  339. package/build/src/toolkit/markdown-table.js.map +1 -1
  340. package/build/src/toolkit/nova-identity.d.ts +19 -0
  341. package/build/src/toolkit/nova-identity.d.ts.map +1 -0
  342. package/build/src/toolkit/nova-identity.js +141 -0
  343. package/build/src/toolkit/nova-identity.js.map +1 -0
  344. package/build/src/types/cli/generate/github/funding.d.ts +4 -4
  345. package/build/src/types/cli/generate/github/issue-template.d.ts +15 -35
  346. package/build/src/types/cli/generate/github/workflows-blueprint-validate.d.ts +351 -0
  347. package/build/src/types/cli/generate/github/workflows-blueprint-variables.d.ts +131 -0
  348. package/build/src/types/cli/generate/github/workflows-blueprint.d.ts +1180 -0
  349. package/build/src/types/cli/generate/must-haves/agent-conventions.d.ts +9 -2
  350. package/build/src/types/cli/generate/must-haves/dotenv.d.ts +101 -314
  351. package/build/src/types/cli/generate/must-haves/editorconfig.d.ts +2 -2
  352. package/build/src/types/cli/generate/must-haves/gitignore.d.ts +13 -343
  353. package/build/src/types/cli/generate/must-haves/license.d.ts +5 -5
  354. package/build/src/types/cli/generate/must-haves/read-me.d.ts +136 -88
  355. package/build/src/types/cli/index.d.ts +14 -0
  356. package/build/src/types/cli/recipe/github/handle-gh-failure.d.ts +2 -2
  357. package/build/src/types/cli/recipe/github/sync-features.d.ts +20 -13
  358. package/build/src/types/cli/recipe/github/sync-identity.d.ts +20 -13
  359. package/build/src/types/cli/recipe/github/sync-policies.d.ts +24 -15
  360. package/build/src/types/cli/recipe/index.d.ts +7 -3
  361. package/build/src/types/cli/recipe/license/update-copyright.d.ts +142 -0
  362. package/build/src/types/cli/recipe/package-json/cleanup.d.ts +26 -22
  363. package/build/src/types/cli/recipe/package-json/normalize-artifacts.d.ts +22 -16
  364. package/build/src/types/cli/recipe/package-json/normalize-bundler.d.ts +20 -14
  365. package/build/src/types/cli/recipe/package-json/normalize-dependencies.d.ts +31 -19
  366. package/build/src/types/cli/recipe/package-json/normalize-modules.d.ts +20 -14
  367. package/build/src/types/cli/recipe/package-json/normalize-tooling.d.ts +20 -14
  368. package/build/src/types/cli/recipe/package-json/sync-environment.d.ts +46 -22
  369. package/build/src/types/cli/recipe/package-json/sync-identity.d.ts +36 -19
  370. package/build/src/types/cli/recipe/package-json/sync-ownership.d.ts +33 -23
  371. package/build/src/types/cli/recipe/read-me/update-badges.d.ts +77 -0
  372. package/build/src/types/cli/recipe/read-me/update-credits.d.ts +77 -0
  373. package/build/src/types/cli/recipe/read-me/update-documentation.d.ts +77 -0
  374. package/build/src/types/cli/recipe/read-me/update-header.d.ts +77 -0
  375. package/build/src/types/cli/recipe/read-me/update-introduction.d.ts +77 -0
  376. package/build/src/types/cli/scaffold/starter/base.d.ts +2 -2
  377. package/build/src/types/cli/utility/changelog.d.ts +165 -73
  378. package/build/src/types/cli/utility/initialize.d.ts +1007 -350
  379. package/build/src/types/cli/utility/run-scripts.d.ts +1 -1
  380. package/build/src/types/cli/utility/transpile.d.ts +8 -3
  381. package/build/src/types/cli/utility/type-check.d.ts +9 -3
  382. package/build/src/types/cli/utility/version.d.ts +32 -32
  383. package/build/src/types/lib/constants.d.ts +1 -1
  384. package/build/src/types/lib/dotenv.d.ts +67 -0
  385. package/build/src/types/lib/env-github.d.ts +67 -0
  386. package/build/src/types/lib/env-managed-set.d.ts +90 -0
  387. package/build/src/types/lib/env-namespace.d.ts +22 -0
  388. package/build/src/types/lib/env-reconcile.d.ts +71 -0
  389. package/build/src/types/lib/env-status.d.ts +102 -0
  390. package/build/src/types/lib/file-discovery.d.ts +40 -0
  391. package/build/src/types/lib/item.d.ts +42 -0
  392. package/build/src/types/lib/markdown-slug.d.ts +25 -0
  393. package/build/src/types/lib/nova-config.d.ts +455 -68
  394. package/build/src/types/lib/read-me-regions.d.ts +51 -0
  395. package/build/src/types/lib/regex.d.ts +193 -18
  396. package/build/src/types/lib/scaffold.d.ts +43 -23
  397. package/build/src/types/lib/type-declaration-engine.d.ts +1052 -0
  398. package/build/src/types/lib/utility.d.ts +40 -6
  399. package/build/src/types/lib/workflow-templates.d.ts +11 -75
  400. package/build/src/types/presets/eslint/fw-astro.d.ts +8 -0
  401. package/build/src/types/rules/eslint/conventions/no-implicit-boolean.d.ts +7 -0
  402. package/build/src/types/rules/eslint/conventions/require-naming-convention.d.ts +8 -4
  403. package/build/src/types/rules/eslint/conventions/require-node-protocol.d.ts +56 -0
  404. package/build/src/types/rules/eslint/formatting/require-padding-lines.d.ts +2 -0
  405. package/build/src/types/rules/eslint/formatting/require-ternary-parens.d.ts +8 -3
  406. package/build/src/types/rules/eslint/jsdoc/require-jsdoc-body.d.ts +16 -0
  407. package/build/src/types/rules/eslint/jsdoc/require-jsdoc-hierarchy.d.ts +19 -15
  408. package/build/src/types/rules/eslint/jsdoc/require-jsdoc-param-name.d.ts +3 -1
  409. package/build/src/types/rules/eslint/jsdoc/require-jsdoc-presence.d.ts +125 -0
  410. package/build/src/types/rules/eslint/jsdoc/require-jsdoc-returns.d.ts +48 -0
  411. package/build/src/types/rules/eslint/jsdoc/require-jsdoc-since.d.ts +71 -1
  412. package/build/src/types/rules/eslint/jsdoc/require-jsdoc-tag-order.d.ts +204 -0
  413. package/build/src/types/rules/eslint/patterns/no-await-in-loop.d.ts +1 -1
  414. package/build/src/types/rules/eslint/patterns/no-bracket-method-call.d.ts +1 -1
  415. package/build/src/types/rules/eslint/regex/no-regex-literals.d.ts +44 -0
  416. package/build/src/types/rules/eslint/typescript/require-bracket-property-access.d.ts +19 -7
  417. package/build/src/types/rules/eslint/typescript/require-type-naming.d.ts +3 -3
  418. package/build/src/types/rules/vitest/active-vitest.d.ts +31 -0
  419. package/build/src/types/rules/vitest/dotenv/register.d.ts +31 -0
  420. package/build/src/types/rules/vitest/dotenv/rules.d.ts +29 -0
  421. package/build/src/types/rules/vitest/enable.d.ts +12 -0
  422. package/build/src/types/rules/vitest/frontmatter/register.d.ts +63 -0
  423. package/build/src/types/rules/vitest/frontmatter/rules.d.ts +430 -0
  424. package/build/src/types/rules/vitest/index.d.ts +419 -0
  425. package/build/src/types/rules/vitest/link/register.d.ts +79 -0
  426. package/build/src/types/rules/vitest/link/rules.d.ts +368 -0
  427. package/build/src/types/rules/vitest/markdown-table/register.d.ts +33 -0
  428. package/build/src/types/rules/vitest/markdown-table/rules.d.ts +55 -0
  429. package/build/src/types/rules/vitest/terminology/register.d.ts +48 -0
  430. package/build/src/types/rules/vitest/terminology/rules.d.ts +190 -0
  431. package/build/src/types/rules/vitest/type-declarations/register.d.ts +46 -0
  432. package/build/src/types/rules/vitest/type-declarations/rules.d.ts +894 -0
  433. package/build/src/types/shared.d.ts +727 -26
  434. package/build/src/types/tests/cli/generate/github/funding.test.d.ts +14 -10
  435. package/build/src/types/tests/cli/generate/github/issue-template.test.d.ts +38 -17
  436. package/build/src/types/tests/cli/generate/github/workflows-blueprint-generate.test.d.ts +199 -0
  437. package/build/src/types/tests/cli/generate/github/workflows-blueprint-parity.test.d.ts +75 -0
  438. package/build/src/types/tests/cli/generate/github/workflows-blueprint-publish-parity.test.d.ts +295 -0
  439. package/build/src/types/tests/cli/generate/github/workflows-blueprint-validate.test.d.ts +901 -0
  440. package/build/src/types/tests/cli/generate/github/workflows-blueprint-variables.test.d.ts +144 -0
  441. package/build/src/types/tests/cli/generate/github/workflows-blueprint.test.d.ts +332 -0
  442. package/build/src/types/tests/cli/generate/must-haves/agent-conventions.test.d.ts +83 -11
  443. package/build/src/types/tests/cli/generate/must-haves/dotenv.test.d.ts +142 -12
  444. package/build/src/types/tests/cli/generate/must-haves/editorconfig.test.d.ts +12 -8
  445. package/build/src/types/tests/cli/generate/must-haves/gitignore.test.d.ts +14 -19
  446. package/build/src/types/tests/cli/generate/must-haves/read-me.test.d.ts +33 -10
  447. package/build/src/types/tests/cli/recipe/github/handle-gh-failure.test.d.ts +28 -24
  448. package/build/src/types/tests/cli/recipe/github/sync-features.test.d.ts +115 -111
  449. package/build/src/types/tests/cli/recipe/github/sync-identity.test.d.ts +192 -142
  450. package/build/src/types/tests/cli/recipe/github/sync-policies.test.d.ts +199 -126
  451. package/build/src/types/tests/cli/recipe/license/update-copyright.test.d.ts +617 -0
  452. package/build/src/types/tests/cli/recipe/package-json/normalize-dependencies.test.d.ts +27 -0
  453. package/build/src/types/tests/cli/recipe/package-json/sync-environment.test.d.ts +21 -0
  454. package/build/src/types/tests/cli/recipe/package-json/sync-identity.test.d.ts +52 -0
  455. package/build/src/types/tests/cli/recipe/read-me/update-badges.test.d.ts +258 -0
  456. package/build/src/types/tests/cli/recipe/read-me/update-credits.test.d.ts +258 -0
  457. package/build/src/types/tests/cli/recipe/read-me/update-documentation.test.d.ts +258 -0
  458. package/build/src/types/tests/cli/recipe/read-me/update-header.test.d.ts +258 -0
  459. package/build/src/types/tests/cli/recipe/read-me/update-introduction.test.d.ts +258 -0
  460. package/build/src/types/tests/cli/scaffold/docs/docusaurus.test.d.ts +4 -0
  461. package/build/src/types/tests/cli/utility/changelog.test.d.ts +293 -0
  462. package/build/src/types/tests/cli/utility/initialize.test.d.ts +148 -1
  463. package/build/src/types/tests/lib/dotenv.test.d.ts +95 -0
  464. package/build/src/types/tests/lib/file-discovery.test.d.ts +37 -0
  465. package/build/src/types/tests/lib/item.test.d.ts +21 -0
  466. package/build/src/types/tests/lib/markdown-slug.test.d.ts +24 -0
  467. package/build/src/types/tests/lib/nova-config.test.d.ts +503 -83
  468. package/build/src/types/tests/lib/read-me-regions.test.d.ts +43 -0
  469. package/build/src/types/tests/lib/regex.test.d.ts +252 -0
  470. package/build/src/types/tests/lib/utility.test.d.ts +35 -0
  471. package/build/src/types/tests/lib/workflow-templates.test.d.ts +18 -2
  472. package/build/src/types/tests/rules/eslint/conventions/require-node-protocol.test.d.ts +8 -0
  473. package/build/src/types/tests/rules/eslint/jsdoc/require-jsdoc-presence.test.d.ts +8 -0
  474. package/build/src/types/tests/rules/eslint/jsdoc/require-jsdoc-returns.test.d.ts +8 -0
  475. package/build/src/types/tests/rules/eslint/jsdoc/require-jsdoc-since.test.d.ts +18 -0
  476. package/build/src/types/tests/rules/eslint/jsdoc/require-jsdoc-tag-order.test.d.ts +8 -0
  477. package/build/src/types/tests/rules/vitest/active-vitest.test.d.ts +56 -0
  478. package/build/src/types/tests/rules/vitest/dotenv.test.d.ts +19 -0
  479. package/build/src/types/tests/rules/vitest/enable.test.d.ts +27 -0
  480. package/build/src/types/tests/rules/vitest/frontmatter.test.d.ts +22 -0
  481. package/build/src/types/tests/rules/vitest/link.test.d.ts +74 -0
  482. package/build/src/types/tests/rules/vitest/markdown-table.test.d.ts +28 -0
  483. package/build/src/types/tests/rules/vitest/terminology.test.d.ts +43 -0
  484. package/build/src/types/tests/rules/vitest/type-declarations.test.d.ts +10 -0
  485. package/build/src/types/tests/scaffold-version-drift.test.d.ts +42 -0
  486. package/build/src/types/tests/since-version.test.d.ts +137 -0
  487. package/build/src/types/tests/toolkit/logger.test.d.ts +70 -5
  488. package/build/src/types/tests/toolkit/nova-identity.test.d.ts +118 -0
  489. package/build/src/types/tests/type-declarations.test.d.ts +40 -1813
  490. package/build/src/types/toolkit/logger.d.ts +4 -0
  491. package/build/src/types/toolkit/nova-identity.d.ts +313 -0
  492. package/build/templates/generators/github/workflows/check-sponsor-gated-issues/base.yml +1 -1
  493. package/build/templates/generators/github/workflows/publish/base.yml +3 -1
  494. package/build/templates/generators/github/workflows/publish/targets/cloudflare-pages-docusaurus.yml +1 -1
  495. package/build/templates/generators/github/workflows/publish/targets/cloudflare-workers.yml +36 -0
  496. package/build/templates/generators/github/workflows/publish/targets/docker-hub.yml +1 -1
  497. package/build/templates/generators/github/workflows/publish/targets/ghcr.yml +1 -1
  498. package/build/templates/generators/github/workflows/publish/targets/github-action.yml +1 -1
  499. package/build/templates/generators/github/workflows/publish/targets/github-packages.yml +1 -1
  500. package/build/templates/generators/github/workflows/publish/targets/github-pages-docusaurus.yml +4 -4
  501. package/build/templates/generators/github/workflows/publish/targets/npm.yml +1 -1
  502. package/build/templates/generators/github/workflows/publish/targets/vercel-nextjs.yml +1 -1
  503. package/build/templates/generators/must-haves/agent-conventions/AGENTS.md +1 -2
  504. package/build/templates/generators/must-haves/agent-conventions/CLAUDE.md +1 -2
  505. package/build/templates/generators/must-haves/agent-conventions/conventions/java.md +5 -5
  506. package/build/templates/generators/must-haves/agent-conventions/conventions/kotlin.md +4 -4
  507. package/build/templates/generators/must-haves/agent-conventions/conventions/php.md +2 -2
  508. package/build/templates/generators/must-haves/agent-conventions/conventions/typescript.md +6 -6
  509. package/build/templates/generators/must-haves/agent-conventions/conventions/universal.md +2 -0
  510. package/build/templates/generators/must-haves/dotenv/env +5 -2
  511. package/build/templates/generators/must-haves/dotenv/env.sample +6 -3
  512. package/build/templates/generators/must-haves/gitignore/gitignore +6 -0
  513. package/build/templates/scaffold/app/express/package.json +5 -5
  514. package/build/templates/scaffold/app/nextjs/package.json +7 -7
  515. package/build/templates/scaffold/app/vite/package.json +3 -3
  516. package/build/templates/scaffold/app/workers/package.json +3 -3
  517. package/build/templates/scaffold/docs/docusaurus/docs/intro.md +6 -0
  518. package/build/templates/scaffold/docs/docusaurus/docusaurus.config.ts +9 -3
  519. package/build/templates/scaffold/docs/docusaurus/package.json +14 -7
  520. package/build/templates/scaffold/docs/docusaurus/src/tests/frontmatter.test.ts +25 -0
  521. package/build/templates/scaffold/docs/docusaurus/src/tests/link.test.ts +16 -0
  522. package/build/templates/scaffold/docs/docusaurus/src/tests/markdown-table.test.ts +16 -0
  523. package/build/templates/scaffold/docs/docusaurus/src/tests/terminology.test.ts +16 -0
  524. package/build/templates/scaffold/docs/docusaurus/src/tests/type-declarations.test.ts +17 -0
  525. package/build/templates/scaffold/docs/docusaurus/vitest.config.ts +22 -0
  526. package/build/templates/scaffold/docs/docusaurus/vitest.setup.ts +26 -0
  527. package/package.json +14 -10
  528. package/build/src/cli/generate/github/workflows.d.ts +0 -17
  529. package/build/src/cli/generate/github/workflows.d.ts.map +0 -1
  530. package/build/src/cli/generate/github/workflows.js +0 -856
  531. package/build/src/cli/generate/github/workflows.js.map +0 -1
  532. package/build/src/types/cli/generate/github/workflows.d.ts +0 -596
  533. package/build/src/types/tests/cli/generate/github/workflows-helpers.test.d.ts +0 -239
  534. package/build/src/types/tests/cli/generate/github/workflows.test.d.ts +0 -587
  535. package/build/templates/generators/github/workflows/publish/targets/aws-amplify-nextjs.yml +0 -32
  536. package/build/templates/generators/must-haves/agent-conventions/cursorrules +0 -55
@@ -180,6 +180,10 @@ export type Toolkit_Logger_Runner_ShouldLog_CurrentLogLevel = string;
180
180
 
181
181
  export type Toolkit_Logger_Runner_ShouldLog_DefaultLogLevel = Shared_LogLevel | undefined;
182
182
 
183
+ export type Toolkit_Logger_Runner_ShouldLog_IsAutoLogLevel = boolean;
184
+
185
+ export type Toolkit_Logger_Runner_ShouldLog_IsUserSelectableLevel = boolean;
186
+
183
187
  export type Toolkit_Logger_Runner_ShouldLog_PreferredLogLevelCurrentLogLevel = Shared_LogLevel;
184
188
 
185
189
  export type Toolkit_Logger_Runner_ShouldLog_PreferredLogLevel = Toolkit_Logger_Runner_ShouldLog_PreferredLogLevelCurrentLogLevel;
@@ -0,0 +1,313 @@
1
+ /**
2
+ * Toolkit - Nova Identity - Title.
3
+ *
4
+ * @since 0.21.0
5
+ */
6
+ export type Toolkit_NovaIdentity_Runner_Title = string | undefined;
7
+
8
+ /**
9
+ * Toolkit - Nova Identity - Slug.
10
+ *
11
+ * @since 0.21.0
12
+ */
13
+ export type Toolkit_NovaIdentity_Runner_Slug = string | undefined;
14
+
15
+ /**
16
+ * Toolkit - Nova Identity - Tagline.
17
+ *
18
+ * @since 0.21.0
19
+ */
20
+ export type Toolkit_NovaIdentity_Runner_Tagline = string | undefined;
21
+
22
+ /**
23
+ * Toolkit - Nova Identity - Legal Name.
24
+ *
25
+ * @since 0.21.0
26
+ */
27
+ export type Toolkit_NovaIdentity_Runner_LegalName = string | undefined;
28
+
29
+ /**
30
+ * Toolkit - Nova Identity - Starting Year.
31
+ *
32
+ * @since 0.21.0
33
+ */
34
+ export type Toolkit_NovaIdentity_Runner_StartingYear = number | undefined;
35
+
36
+ /**
37
+ * Toolkit - Nova Identity - Owner.
38
+ *
39
+ * @since 0.21.0
40
+ */
41
+ export type Toolkit_NovaIdentity_Runner_Owner = string | undefined;
42
+
43
+ /**
44
+ * Toolkit - Nova Identity - Homepage.
45
+ *
46
+ * @since 0.21.0
47
+ */
48
+ export type Toolkit_NovaIdentity_Runner_Homepage = string | undefined;
49
+
50
+ /**
51
+ * Toolkit - Nova Identity - Logo.
52
+ *
53
+ * @since 0.21.0
54
+ */
55
+ export type Toolkit_NovaIdentity_Runner_Logo = string | undefined;
56
+
57
+ /**
58
+ * Toolkit - Nova Identity - Repository.
59
+ *
60
+ * @since 0.21.0
61
+ */
62
+ export type Toolkit_NovaIdentity_Runner_Repository = string | undefined;
63
+
64
+ /**
65
+ * Toolkit - Nova Identity - Npm.
66
+ *
67
+ * @since 0.21.0
68
+ */
69
+ export type Toolkit_NovaIdentity_Runner_Npm = string | undefined;
70
+
71
+ /**
72
+ * Toolkit - Nova Identity - Bugs.
73
+ *
74
+ * @since 0.21.0
75
+ */
76
+ export type Toolkit_NovaIdentity_Runner_Bugs = string | undefined;
77
+
78
+ /**
79
+ * Toolkit - Nova Identity - Documentation.
80
+ *
81
+ * @since 0.21.0
82
+ */
83
+ export type Toolkit_NovaIdentity_Runner_Documentation = string | undefined;
84
+
85
+ /**
86
+ * Toolkit - Nova Identity - Privacy Policy.
87
+ *
88
+ * @since 0.21.0
89
+ */
90
+ export type Toolkit_NovaIdentity_Runner_PrivacyPolicy = string | undefined;
91
+
92
+ /**
93
+ * Toolkit - Nova Identity - Terms Of Use.
94
+ *
95
+ * @since 0.21.0
96
+ */
97
+ export type Toolkit_NovaIdentity_Runner_TermsOfUse = string | undefined;
98
+
99
+ /**
100
+ * Toolkit - Nova Identity - Fund Sources.
101
+ *
102
+ * @since 0.21.0
103
+ */
104
+ export type Toolkit_NovaIdentity_Runner_FundSources = string[];
105
+
106
+ /**
107
+ * Toolkit - Nova Identity - Compose Copyright.
108
+ *
109
+ * @since 0.21.0
110
+ */
111
+ export type Toolkit_NovaIdentity_Runner_ComposeCopyright_StartingYear = number;
112
+
113
+ export type Toolkit_NovaIdentity_Runner_ComposeCopyright_LegalName = string;
114
+
115
+ export type Toolkit_NovaIdentity_Runner_ComposeCopyright_Returns = string;
116
+
117
+ export type Toolkit_NovaIdentity_Runner_ComposeCopyright_YearRange = string;
118
+
119
+ /**
120
+ * Toolkit - Nova Identity - Constructor.
121
+ *
122
+ * @since 0.21.0
123
+ */
124
+ export type Toolkit_NovaIdentity_Runner_Constructor_Cwd = string;
125
+
126
+ export type Toolkit_NovaIdentity_Runner_Constructor_StartDirectory = string;
127
+
128
+ export type Toolkit_NovaIdentity_Runner_Constructor_ResolvedConfigPath = string;
129
+
130
+ export type Toolkit_NovaIdentity_Runner_Constructor_Parsed = Record<string, unknown>;
131
+
132
+ export type Toolkit_NovaIdentity_Runner_Constructor_Project = Record<string, unknown>;
133
+
134
+ export type Toolkit_NovaIdentity_Runner_Constructor_ProjectName = Record<string, unknown>;
135
+
136
+ export type Toolkit_NovaIdentity_Runner_Constructor_ProjectDescription = Record<string, unknown>;
137
+
138
+ export type Toolkit_NovaIdentity_Runner_Constructor_Github = Record<string, unknown>;
139
+
140
+ export type Toolkit_NovaIdentity_Runner_Constructor_Urls = Record<string, unknown>;
141
+
142
+ /**
143
+ * Toolkit - Nova Identity - Copyright Year Range.
144
+ *
145
+ * @since 0.21.0
146
+ */
147
+ export type Toolkit_NovaIdentity_Runner_CopyrightYearRange_StartingYear = number;
148
+
149
+ export type Toolkit_NovaIdentity_Runner_CopyrightYearRange_Returns = string;
150
+
151
+ export type Toolkit_NovaIdentity_Runner_CopyrightYearRange_CurrentYear = number;
152
+
153
+ /**
154
+ * Toolkit - Nova Identity - For Docs.
155
+ *
156
+ * @since 0.21.0
157
+ */
158
+ export type Toolkit_NovaIdentity_Runner_ForDocs_Returns_Title = string | undefined;
159
+
160
+ export type Toolkit_NovaIdentity_Runner_ForDocs_Returns_ProjectName = string | undefined;
161
+
162
+ export type Toolkit_NovaIdentity_Runner_ForDocs_Returns_OrganizationName = string | undefined;
163
+
164
+ export type Toolkit_NovaIdentity_Runner_ForDocs_Returns_Tagline = string | undefined;
165
+
166
+ export type Toolkit_NovaIdentity_Runner_ForDocs_Returns_Url = string | undefined;
167
+
168
+ export type Toolkit_NovaIdentity_Runner_ForDocs_Returns_Logo = string | undefined;
169
+
170
+ export type Toolkit_NovaIdentity_Runner_ForDocs_Returns_MetaDescription = string | undefined;
171
+
172
+ export type Toolkit_NovaIdentity_Runner_ForDocs_Returns_Copyright = string | undefined;
173
+
174
+ export type Toolkit_NovaIdentity_Runner_ForDocs_Returns_EditUrl = string | undefined;
175
+
176
+ export type Toolkit_NovaIdentity_Runner_ForDocs_Returns_Repository = string | undefined;
177
+
178
+ export type Toolkit_NovaIdentity_Runner_ForDocs_Returns_Github = string | undefined;
179
+
180
+ export type Toolkit_NovaIdentity_Runner_ForDocs_Returns_Npm = string | undefined;
181
+
182
+ export type Toolkit_NovaIdentity_Runner_ForDocs_Returns_Bugs = string | undefined;
183
+
184
+ export type Toolkit_NovaIdentity_Runner_ForDocs_Returns_Documentation = string | undefined;
185
+
186
+ export type Toolkit_NovaIdentity_Runner_ForDocs_Returns_PrivacyPolicy = string | undefined;
187
+
188
+ export type Toolkit_NovaIdentity_Runner_ForDocs_Returns_TermsOfUse = string | undefined;
189
+
190
+ export type Toolkit_NovaIdentity_Runner_ForDocs_Returns_Funding = string[];
191
+
192
+ export type Toolkit_NovaIdentity_Runner_ForDocs_Returns = {
193
+ title: Toolkit_NovaIdentity_Runner_ForDocs_Returns_Title;
194
+ projectName: Toolkit_NovaIdentity_Runner_ForDocs_Returns_ProjectName;
195
+ organizationName: Toolkit_NovaIdentity_Runner_ForDocs_Returns_OrganizationName;
196
+ tagline: Toolkit_NovaIdentity_Runner_ForDocs_Returns_Tagline;
197
+ url: Toolkit_NovaIdentity_Runner_ForDocs_Returns_Url;
198
+ logo: Toolkit_NovaIdentity_Runner_ForDocs_Returns_Logo;
199
+ metaDescription: Toolkit_NovaIdentity_Runner_ForDocs_Returns_MetaDescription;
200
+ copyright: Toolkit_NovaIdentity_Runner_ForDocs_Returns_Copyright;
201
+ editUrl: Toolkit_NovaIdentity_Runner_ForDocs_Returns_EditUrl;
202
+ repository: Toolkit_NovaIdentity_Runner_ForDocs_Returns_Repository;
203
+ github: Toolkit_NovaIdentity_Runner_ForDocs_Returns_Github;
204
+ npm: Toolkit_NovaIdentity_Runner_ForDocs_Returns_Npm;
205
+ bugs: Toolkit_NovaIdentity_Runner_ForDocs_Returns_Bugs;
206
+ documentation: Toolkit_NovaIdentity_Runner_ForDocs_Returns_Documentation;
207
+ privacyPolicy: Toolkit_NovaIdentity_Runner_ForDocs_Returns_PrivacyPolicy;
208
+ termsOfUse: Toolkit_NovaIdentity_Runner_ForDocs_Returns_TermsOfUse;
209
+ funding: Toolkit_NovaIdentity_Runner_ForDocs_Returns_Funding;
210
+ };
211
+
212
+ /**
213
+ * Toolkit - Nova Identity - Github User Url.
214
+ *
215
+ * @since 0.21.0
216
+ */
217
+ export type Toolkit_NovaIdentity_Runner_GithubUserUrl_Owner = string;
218
+
219
+ export type Toolkit_NovaIdentity_Runner_GithubUserUrl_Returns = string;
220
+
221
+ /**
222
+ * Toolkit - Nova Identity - Normalize Repo Url.
223
+ *
224
+ * @since 0.21.0
225
+ */
226
+ export type Toolkit_NovaIdentity_Runner_NormalizeRepoUrl_RepositoryUrl = string;
227
+
228
+ export type Toolkit_NovaIdentity_Runner_NormalizeRepoUrl_Returns = string;
229
+
230
+ export type Toolkit_NovaIdentity_Runner_NormalizeRepoUrl_Stripped = string;
231
+
232
+ /**
233
+ * Toolkit - Nova Identity - Optional Number.
234
+ *
235
+ * @since 0.21.0
236
+ */
237
+ export type Toolkit_NovaIdentity_Runner_OptionalNumber_Value = unknown;
238
+
239
+ export type Toolkit_NovaIdentity_Runner_OptionalNumber_FieldPath = string;
240
+
241
+ export type Toolkit_NovaIdentity_Runner_OptionalNumber_ConfigPath = string;
242
+
243
+ export type Toolkit_NovaIdentity_Runner_OptionalNumber_Returns = number | undefined;
244
+
245
+ /**
246
+ * Toolkit - Nova Identity - Optional String.
247
+ *
248
+ * @since 0.21.0
249
+ */
250
+ export type Toolkit_NovaIdentity_Runner_OptionalString_Value = unknown;
251
+
252
+ export type Toolkit_NovaIdentity_Runner_OptionalString_FieldPath = string;
253
+
254
+ export type Toolkit_NovaIdentity_Runner_OptionalString_ConfigPath = string;
255
+
256
+ export type Toolkit_NovaIdentity_Runner_OptionalString_Returns = string | undefined;
257
+
258
+ /**
259
+ * Toolkit - Nova Identity - Optional String Array.
260
+ *
261
+ * @since 0.21.0
262
+ */
263
+ export type Toolkit_NovaIdentity_Runner_OptionalStringArray_Value = unknown;
264
+
265
+ export type Toolkit_NovaIdentity_Runner_OptionalStringArray_Returns = string[];
266
+
267
+ /**
268
+ * Toolkit - Nova Identity - Read Config.
269
+ *
270
+ * @since 0.21.0
271
+ */
272
+ export type Toolkit_NovaIdentity_Runner_ReadConfig_ConfigPath = string;
273
+
274
+ export type Toolkit_NovaIdentity_Runner_ReadConfig_Returns = Record<string, unknown>;
275
+
276
+ export type Toolkit_NovaIdentity_Runner_ReadConfig_RawFile = string;
277
+
278
+ /**
279
+ * Toolkit - Nova Identity - Resolve Config Path.
280
+ *
281
+ * @since 0.21.0
282
+ */
283
+ export type Toolkit_NovaIdentity_Runner_ResolveConfigPath_StartDirectory = string;
284
+
285
+ export type Toolkit_NovaIdentity_Runner_ResolveConfigPath_Returns = string;
286
+
287
+ export type Toolkit_NovaIdentity_Runner_ResolveConfigPath_CurrentDirectory = string;
288
+
289
+ export type Toolkit_NovaIdentity_Runner_ResolveConfigPath_CandidatePath = string;
290
+
291
+ export type Toolkit_NovaIdentity_Runner_ResolveConfigPath_ParentDirectory = string;
292
+
293
+ /**
294
+ * Toolkit - Nova Identity - Section.
295
+ *
296
+ * @since 0.21.0
297
+ */
298
+ export type Toolkit_NovaIdentity_Runner_Section_Root = Record<string, unknown>;
299
+
300
+ export type Toolkit_NovaIdentity_Runner_Section_Key = string;
301
+
302
+ export type Toolkit_NovaIdentity_Runner_Section_Returns = Record<string, unknown>;
303
+
304
+ export type Toolkit_NovaIdentity_Runner_Section_Value = unknown;
305
+
306
+ /**
307
+ * Toolkit - Nova Identity - Strip Trailing Slash.
308
+ *
309
+ * @since 0.21.0
310
+ */
311
+ export type Toolkit_NovaIdentity_Runner_StripTrailingSlash_Url = string;
312
+
313
+ export type Toolkit_NovaIdentity_Runner_StripTrailingSlash_Returns = string;
@@ -33,7 +33,7 @@ jobs:
33
33
  [__JOBS_CONDITION__]
34
34
  steps:
35
35
  - name: "Checkout repository"
36
- uses: "actions/checkout@v6"
36
+ uses: "actions/checkout@v7"
37
37
 
38
38
  - name: "Check support issues"
39
39
  uses: "mrjackyliang/sponsor-gated-support@v1.0.1"
@@ -32,7 +32,9 @@ jobs:
32
32
  [__JOBS_CONDITION__]
33
33
  steps:
34
34
  - name: "Checkout repository"
35
- uses: "actions/checkout@v6"
35
+ uses: "actions/checkout@v7"
36
+ with:
37
+ fetch-depth: 0
36
38
 
37
39
  - name: "Setup Node.js"
38
40
  uses: "actions/setup-node@v6"
@@ -7,7 +7,7 @@ publish-cloudflare-pages-docusaurus-[__TARGET_ID__]:
7
7
  [__JOBS_CONDITION__]
8
8
  steps:
9
9
  - name: "Checkout repository"
10
- uses: "actions/checkout@v6"
10
+ uses: "actions/checkout@v7"
11
11
 
12
12
  - name: "Download build artifacts"
13
13
  uses: "actions/download-artifact@v8"
@@ -0,0 +1,36 @@
1
+ publish-cloudflare-workers-[__TARGET_ID__]:
2
+ needs: [__NEEDS__]
3
+ runs-on: "ubuntu-latest"
4
+ timeout-minutes: 10
5
+ permissions:
6
+ contents: "read"
7
+ [__JOBS_CONDITION__]
8
+ steps:
9
+ - name: "Checkout repository"
10
+ uses: "actions/checkout@v7"
11
+
12
+ - name: "Setup Node.js"
13
+ uses: "actions/setup-node@v6"
14
+ with:
15
+ node-version-file: "${{ env.ROOT_DIR }}/package.json"
16
+ package-manager-cache: false
17
+
18
+ - name: "Install packages"
19
+ run: |
20
+ npm install -g npm@latest
21
+ npm install
22
+ working-directory: "${{ env.ROOT_DIR }}"
23
+
24
+ - name: "Download build artifacts"
25
+ uses: "actions/download-artifact@v8"
26
+ with:
27
+ name: "[__ARTIFACT_NAME__]"
28
+ path: "[__WORKING_DIR__]/build"
29
+
30
+ - name: "Deploy to Cloudflare Workers"
31
+ if: "${{ env.PUBLISH == 'true' }}"
32
+ env:
33
+ CLOUDFLARE_API_TOKEN: "${{ secrets.CLOUDFLARE_API_TOKEN }}"
34
+ CLOUDFLARE_ACCOUNT_ID: "${{ vars.CLOUDFLARE_ACCOUNT_ID }}"
35
+ run: "npm run deploy"
36
+ working-directory: "[__WORKING_DIR__]"
@@ -9,7 +9,7 @@ publish-docker-hub-[__TARGET_ID__]:
9
9
  [__JOBS_CONDITION__]
10
10
  steps:
11
11
  - name: "Checkout repository"
12
- uses: "actions/checkout@v6"
12
+ uses: "actions/checkout@v7"
13
13
 
14
14
  - name: "Set up QEMU"
15
15
  uses: "docker/setup-qemu-action@v3"
@@ -10,7 +10,7 @@ publish-ghcr-[__TARGET_ID__]:
10
10
  [__JOBS_CONDITION__]
11
11
  steps:
12
12
  - name: "Checkout repository"
13
- uses: "actions/checkout@v6"
13
+ uses: "actions/checkout@v7"
14
14
 
15
15
  - name: "Set up QEMU"
16
16
  uses: "docker/setup-qemu-action@v3"
@@ -9,7 +9,7 @@ publish-github-action-[__TARGET_ID__]:
9
9
  [__JOBS_CONDITION__]
10
10
  steps:
11
11
  - name: "Checkout repository"
12
- uses: "actions/checkout@v6"
12
+ uses: "actions/checkout@v7"
13
13
  with:
14
14
  persist-credentials: false
15
15
 
@@ -9,7 +9,7 @@ publish-github-packages-[__TARGET_ID__]:
9
9
  [__JOBS_CONDITION__]
10
10
  steps:
11
11
  - name: "Checkout repository"
12
- uses: "actions/checkout@v6"
12
+ uses: "actions/checkout@v7"
13
13
 
14
14
  - name: "Setup Node.js"
15
15
  uses: "actions/setup-node@v6"
@@ -9,7 +9,7 @@ publish-github-pages-docusaurus-[__TARGET_ID__]:
9
9
  [__JOBS_CONDITION__]
10
10
  steps:
11
11
  - name: "Checkout repository"
12
- uses: "actions/checkout@v6"
12
+ uses: "actions/checkout@v7"
13
13
 
14
14
  - name: "Download build artifacts"
15
15
  uses: "actions/download-artifact@v8"
@@ -31,14 +31,14 @@ publish-github-pages-docusaurus-[__TARGET_ID__]:
31
31
 
32
32
  - name: "Setup GitHub Pages"
33
33
  if: "${{ env.PUBLISH == 'true' && env.PAGES_ENABLED == 'true' }}"
34
- uses: "actions/configure-pages@v5"
34
+ uses: "actions/configure-pages@v6"
35
35
 
36
36
  - name: "Upload artifact to GitHub Pages"
37
37
  if: "${{ env.PUBLISH == 'true' && env.PAGES_ENABLED == 'true' }}"
38
- uses: "actions/upload-pages-artifact@v4"
38
+ uses: "actions/upload-pages-artifact@v5"
39
39
  with:
40
40
  path: "[__WORKING_DIR__]/build"
41
41
 
42
42
  - name: "Deploy to GitHub Pages"
43
43
  if: "${{ env.PUBLISH == 'true' && env.PAGES_ENABLED == 'true' }}"
44
- uses: "actions/deploy-pages@v4"
44
+ uses: "actions/deploy-pages@v5"
@@ -8,7 +8,7 @@ publish-npm-[__TARGET_ID__]:
8
8
  [__JOBS_CONDITION__]
9
9
  steps:
10
10
  - name: "Checkout repository"
11
- uses: "actions/checkout@v6"
11
+ uses: "actions/checkout@v7"
12
12
 
13
13
  - name: "Setup Node.js"
14
14
  uses: "actions/setup-node@v6"
@@ -7,7 +7,7 @@ publish-vercel-nextjs-[__TARGET_ID__]:
7
7
  [__JOBS_CONDITION__]
8
8
  steps:
9
9
  - name: "Checkout repository"
10
- uses: "actions/checkout@v6"
10
+ uses: "actions/checkout@v7"
11
11
 
12
12
  - name: "Setup Node.js"
13
13
  uses: "actions/setup-node@v6"
@@ -47,9 +47,8 @@ These files contain critical project information — architectural decisions, id
47
47
 
48
48
  ## Restricted Files
49
49
 
50
- These files are managed externally and kept in sync across environments. Modifying them locally will cause drift and merge conflicts.
50
+ These files are managed by Nova's agent-conventions generator (`nova generate must-haves agent-conventions`) and kept in sync across environments. Do not edit them locally; the generator overwrites them on its next run, so local changes are lost and cause drift.
51
51
 
52
- - `.cursorrules`
53
52
  - `CLAUDE.md`
54
53
  - `AGENTS.md`
55
54
  - `conventions/*.md`
@@ -47,9 +47,8 @@ These files contain critical project information — architectural decisions, id
47
47
 
48
48
  ## Restricted Files
49
49
 
50
- These files are managed externally and kept in sync across environments. Modifying them locally will cause drift and merge conflicts.
50
+ These files are managed by Nova's agent-conventions generator (`nova generate must-haves agent-conventions`) and kept in sync across environments. Do not edit them locally; the generator overwrites them on its next run, so local changes are lost and cause drift.
51
51
 
52
- - `.cursorrules`
53
52
  - `CLAUDE.md`
54
53
  - `AGENTS.md`
55
54
  - `conventions/*.md`
@@ -5,7 +5,7 @@ Quotes: Double (only option). Indentation: 4-space. File naming: PascalCase matc
5
5
  ## Documentation Style
6
6
 
7
7
  - Comment syntax: `/** */`
8
- - Padding tag: `@since 1.0.0` (Javadoc)
8
+ - Padding tag: `@since UNRELEASED` (Javadoc) — tag new or changed API with `@since UNRELEASED`; the release process stamps the real version automatically, so never hand-write a version number.
9
9
  - Param format: `@param name - Name.` (description matches the parameter name, capitalized, with a trailing period)
10
10
  - Return format: `@return Type`
11
11
 
@@ -15,13 +15,13 @@ Quotes: Double (only option). Indentation: 4-space. File naming: PascalCase matc
15
15
  /**
16
16
  * Entity Repository.
17
17
  *
18
- * @since 1.0.0
18
+ * @since UNRELEASED
19
19
  */
20
20
  public class EntityRepository {
21
21
  /**
22
22
  * Entity Repository - Database.
23
23
  *
24
- * @since 1.0.0
24
+ * @since UNRELEASED
25
25
  */
26
26
  private final Database database;
27
27
 
@@ -30,7 +30,7 @@ public class EntityRepository {
30
30
  *
31
31
  * @param database - Database.
32
32
  *
33
- * @since 1.0.0
33
+ * @since UNRELEASED
34
34
  */
35
35
  public EntityRepository(Database database) { ... }
36
36
 
@@ -41,7 +41,7 @@ public class EntityRepository {
41
41
  *
42
42
  * @return Entity
43
43
  *
44
- * @since 1.0.0
44
+ * @since UNRELEASED
45
45
  */
46
46
  public Entity findById(UUID id) { ... }
47
47
  }
@@ -5,7 +5,7 @@ Quotes: Double (only option). Indentation: 4-space. File naming: PascalCase matc
5
5
  ## Documentation Style
6
6
 
7
7
  - Comment syntax: `/** */`
8
- - Padding tag: `@since 1.0.0` (KDoc)
8
+ - Padding tag: `@since UNRELEASED` (KDoc) — tag new or changed API with `@since UNRELEASED`; the release process stamps the real version automatically, so never hand-write a version number.
9
9
  - Param format: `@param name - Name.` (description matches the parameter name, capitalized, with a trailing period)
10
10
  - Return format: `@return Type?`
11
11
  - Include `@private` tag for private members.
@@ -16,13 +16,13 @@ Quotes: Double (only option). Indentation: 4-space. File naming: PascalCase matc
16
16
  /**
17
17
  * Entity Repository.
18
18
  *
19
- * @since 1.0.0
19
+ * @since UNRELEASED
20
20
  */
21
21
  class EntityRepository(
22
22
  /**
23
23
  * Entity Repository - Database.
24
24
  *
25
- * @since 1.0.0
25
+ * @since UNRELEASED
26
26
  */
27
27
  private val database: Database,
28
28
  ) {
@@ -33,7 +33,7 @@ class EntityRepository(
33
33
  *
34
34
  * @return Entity?
35
35
  *
36
- * @since 1.0.0
36
+ * @since UNRELEASED
37
37
  */
38
38
  suspend fun findById(id: UUID): Entity? { ... }
39
39
  }
@@ -5,7 +5,7 @@ Quotes: Single (non-interpolated). Indentation: 4-space. File naming: PascalCase
5
5
  ## Documentation Style
6
6
 
7
7
  - Comment syntax: `/** */`
8
- - Padding tag: `@since 1.0.0` (PHPDoc)
8
+ - Padding tag: `@since UNRELEASED` (PHPDoc) — tag new or changed API with `@since UNRELEASED`; the release process stamps the real version automatically, so never hand-write a version number.
9
9
  - Param format: `@param type $name - Name.` (description matches the parameter name, capitalized, with a trailing period)
10
10
  - Return format: `@return type`
11
11
  - Include `@private` tag for private members.
@@ -22,7 +22,7 @@ Quotes: Single (non-interpolated). Indentation: 4-space. File naming: PascalCase
22
22
  *
23
23
  * @return void
24
24
  *
25
- * @since 1.0.0
25
+ * @since UNRELEASED
26
26
  */
27
27
  function backup_config_file(
28
28
  string $backup_name,
@@ -5,7 +5,7 @@ Quotes: Single. Indentation: 2-space. File naming: kebab-case (e.g., `markdown-t
5
5
  ## Documentation Style
6
6
 
7
7
  - Comment syntax: `/** */`
8
- - Padding tag: `@since 1.0.0` (JSDoc)
8
+ - Padding tag: `@since UNRELEASED` (JSDoc) — tag new or changed API with `@since UNRELEASED`; the release process stamps the real version automatically, so never hand-write a version number.
9
9
  - Param format: `@param {TypeName} name - Name.` (description matches the parameter name, capitalized, with a trailing period)
10
10
  - Return format: `@returns {TypeName}`
11
11
  - Include `@private` tag for private members.
@@ -54,7 +54,7 @@ The example below is for the file `src/cli/utility/changelog.ts`. The class is n
54
54
  /**
55
55
  * CLI - Utility - Changelog.
56
56
  *
57
- * @since 1.0.0
57
+ * @since UNRELEASED
58
58
  */
59
59
  export class Runner {
60
60
  /**
@@ -64,7 +64,7 @@ export class Runner {
64
64
  *
65
65
  * @returns {Cli_Utility_Changelog_Runner_Run_Returns}
66
66
  *
67
- * @since 1.0.0
67
+ * @since UNRELEASED
68
68
  */
69
69
  public static async run(options: Cli_Utility_Changelog_Runner_Run_Options): Cli_Utility_Changelog_Runner_Run_Returns {
70
70
  }
@@ -76,7 +76,7 @@ export class Runner {
76
76
  *
77
77
  * @returns {Cli_Utility_Changelog_Runner_FetchData_Returns}
78
78
  *
79
- * @since 1.0.0
79
+ * @since UNRELEASED
80
80
  */
81
81
  private static async fetchData(): Cli_Utility_Changelog_Runner_FetchData_Returns {
82
82
  }
@@ -91,7 +91,7 @@ export class Runner {
91
91
  *
92
92
  * @returns {Cli_Utility_Changelog_Runner_FormatLine_Returns}
93
93
  *
94
- * @since 1.0.0
94
+ * @since UNRELEASED
95
95
  */
96
96
  private static formatLine(prefix: Cli_Utility_Changelog_Runner_FormatLine_Prefix, message: Cli_Utility_Changelog_Runner_FormatLine_Message): Cli_Utility_Changelog_Runner_FormatLine_Returns {
97
97
  }
@@ -377,7 +377,7 @@ export type Toolkit_MarkdownTable_Runner_AddRow_Returns = void;
377
377
  *
378
378
  * @returns {Toolkit_MarkdownTable_Runner_AddRow_Returns}
379
379
  *
380
- * @since 1.0.0
380
+ * @since UNRELEASED
381
381
  */
382
382
  public addRow(row: Toolkit_MarkdownTable_Runner_AddRow_Row): Toolkit_MarkdownTable_Runner_AddRow_Returns { ... }
383
383
  ```
@@ -49,6 +49,8 @@ For visual testing and web page interaction, prefer the Claude-in-Chrome MCP too
49
49
 
50
50
  If the Claude-in-Chrome MCP is not available, fall back to Vercel's `agent-browser` command for headless rendering and interaction. Run `agent-browser --help` for available commands.
51
51
 
52
+ One exception to the MCP-first preference: Claude-in-Chrome screenshots are returned inline in the conversation and cannot be written to disk. When a screenshot must be saved to a file — to attach to a commit, produce an artifact, or include in a report — use `agent-browser` to capture it even when the MCP is available.
53
+
52
54
  Do not use `curl`, `wget`, or other plain HTTP clients for tasks that require rendering, clicking, or inspecting a page.
53
55
 
54
56
  ### Web Research