chore: expose project audit in whisk

Author: Callin Mullaney

UPGRADE.md

@@ -33,19 +33,30 @@ Emulsify 7.x is a breaking release. Plan the upgrade as a theme-platform change,
 - Frontend workflow references should move from Webpack-based build workflow commands and docs to the Vite-based build workflow shipped in 7.x.
 - `whisk` remains a starter source only. Do not enable it as a runtime parent theme.
 
-## Twig Story Migration Audit
+## Project Audit
 
-Generated themes include an audit command for reviewing older Twig stories that
-should move to Emulsify Core's preferred `renderTwig()` helper:
+Generated themes include an audit command for reviewing common frontend upgrade
+items:
+
+```bash
+npm run audit
+```
+
+The command reports Storybook discovery issues, unresolved Twig `include()` or
+`source()` references, Webpack-era patterns, direct imports of Emulsify Core
+internals, platform assumptions, source-root issues, large Twig Storybook roots,
+and older Twig stories that should move to Emulsify Core's preferred
+`renderTwig()` helper.
+
+For only the Twig story migration report, run:
 
 ```bash
 npm run audit:twig-stories
 ```
 
-The command prints a report of likely legacy Storybook files and links to the
-Emulsify Core Storybook migration documentation. Existing Twig stories that
-return HTML strings can continue rendering during the upgrade, but actively
-maintained stories should be migrated to `renderTwig()` as they are touched.
+Existing Twig stories that return HTML strings can continue rendering during the
+upgrade, but actively maintained stories should be migrated to `renderTwig()` as
+they are touched.
 
 ## Theme Architecture Changes
 

whisk/package.json

@@ -18,6 +18,7 @@
   "type": "module",
   "scripts": {
     "a11y": "npm run storybook-build && node_modules/@emulsify/core/scripts/a11y.js -r",
+    "audit": "sh -c 'node_modules/@emulsify/core/scripts/audit.js \"$@\"; status=$?; printf \"\\nAudit docs: https://github.com/emulsify-ds/emulsify-core/blob/4.x/docs/migration-4x.md#storybook-migration\\n\"; exit $status' --",
     "audit:twig-stories": "sh -c 'node_modules/@emulsify/core/scripts/audit-twig-stories.js \"$@\"; status=$?; printf \"\\nMigration docs: https://github.com/emulsify-ds/emulsify-core/blob/4.x/docs/storybook.md#legacy-twig-story-compatibility\\n\"; exit $status' --",
     "build": "npm run ensure-dist && vite --config node_modules/@emulsify/core/config/vite/vite.config.js",
     "coverage": "npm run test && open-cli .coverage/lcov-report/index.html",