[jung-thomas]

What & why

Fixes a runtime-import bug introduced by the directive-grammar foundation (#3021) that is currently failing the unit CI job on every open fan-out PR (#3024–#3028) and would also break at CF runtime.

srv/lib/freshness-detector.js statically imported ../../scripts/parsers/directives.js for renderDirectivesAsText. Only directives.ts exists on disk, so:

1. CI/test: test/unit/freshness-actions.test.js boots a real CAP HTTP server; Node's native ESM loader resolves the static import outside Vitest's transform and throws ERR_MODULE_NOT_FOUND. This landed on DEV with feat(directives): generic tutorial directive grammar foundation (openspec: tutorial-directive-grammar) #3021 and every PR's merge-ref CI inherits it.
2. CF runtime: cds build --production copies only srv/ into gen/srv/ — scripts/parsers/ is never included, so the import would fail in production too.

Fix

Adopts the repo's existing workspace-first / bundle-fallback pattern (same as srv/lib/tutorial-step-slicer.js):

• scripts/bundle-shared.cjs — add a parsers.bundle.mjs target (direct file-path entry, since scripts/parsers isn't a workspace package) to the main targets array only → srv/lib/_shared/parsers.bundle.mjs. (Not added to QA/MCP target arrays — freshness-detector.js is only used by the srv app.)
• srv/lib/freshness-detector.js — replace the static top-level import with a lazy await import() inside the already-async detectFreshness(): try the workspace ../../scripts/parsers/directives.js (resolves in dev/test), catch to ./_shared/parsers.bundle.mjs (generated at build, present in gen/srv/ on CF).

The generated bundle is not committed — srv/lib/_shared/ is gitignored and prebuild:shared-bundle regenerates it before cds build (same as the existing *.bundle.mjs). Verified: prebuild → prebuild:shared-bundle fires before build:cds.

How tested

• npx vitest run test/unit/freshness-actions.test.js → 3/3 pass
• npx vitest run test/unit/freshness-detector.test.js → 3/3 pass
• Verified prebuild:shared-bundle runs in the CF build chain before cds build --production, so parsers.bundle.mjs exists in gen/srv/srv/lib/_shared/ at runtime.
• Both edited files LF-clean.

Type of change

• Bug fix

Deploy scope

• Backend only (srv/**, scripts/**) — no content, no UI.

Notes for reviewers

• After this merges to DEV, the 7 fan-out feature PRs (feat(directives): callout enhancements (openspec: tutorial-callout-enhancements) #3024–feat(directives): tutorial content reuse and smart references (#content-reuse-and-references) #3028, plus the already-merged feat(directives): authoring aids (openspec: tutorial-authoring-aids) #3022/feat(synced-tabs): synced OPTION tab groups (openspec: tutorial-synced-option-tabs) #3023) go green on their next CI run.
• Related latent bug, NOT fixed here (separate follow-up): packages/mcp/tutorial-step-slicer.js has the same renderDirectivesAsText static import; its unit path is masked today (bundle fallback + KG_STEP_SLICER_ENABLED falsy), but it would hit the same CF-runtime failure when that flag is on. Flagged for a follow-up PR.

Checklist

• Branched from DEV
• No secrets committed
• cds.ql/CQL only (no raw SQL) — n/a, no DB change