Generate Demo Artifacts

Purpose

Regenerate all demo markdown artifacts using the current code. This ensures UAT tests validate the actual behavior of the tool, not stale output.

Hard Rules

Must

• Use the stable wrapper script: scripts/generate-demo-artifacts.sh
• Script will handle building, generating artifacts, and verification automatically
• Always allow this script — it only reads input files and writes artifacts, no dangerous operations

Must Not

• Modify the input plan.json or demo-principals.json files
• Run individual dotnet commands instead of the wrapper script
• Skip verification of generated output

Actions

Generate All Demo Artifacts

scripts/generate-demo-artifacts.sh

This single command:

1. Builds the project in Release configuration
2. Generates all artifacts in /artifacts/ (used for UAT):
   • comprehensive-demo.md (inline-diff format, for Azure DevOps UAT)
   • comprehensive-demo-standard-diff.md (standard diff format, for GitHub UAT)
   • role.md (role assignments with principal mapping)
   • role-default.md (role assignments without principal mapping)
3. Generates all documentation samples in examples/comprehensive-demo/:
   • report.md (default template)
   • report-with-sensitive.md (with --show-sensitive)
   • report-summary.md (summary template)
4. Verifies all outputs are valid markdown
5. Reports success or failure with clear error messages

Expected Output

[INFO] Building project (Release configuration)...
[INFO] Generating artifacts/comprehensive-demo.md (inline-diff, for Azure DevOps UAT)...
[INFO] ✓ artifacts/comprehensive-demo.md generated successfully (inline-diff)
[INFO] Generating artifacts/comprehensive-demo-standard-diff.md (for GitHub UAT)...
[INFO] ✓ artifacts/comprehensive-demo-standard-diff.md generated successfully
[INFO] Generating artifacts/role.md (role assignments with principal mapping)...
[INFO] ✓ artifacts/role.md generated successfully
[INFO] Generating artifacts/role-default.md (role assignments without principal mapping)...
[INFO] ✓ artifacts/role-default.md generated successfully
[INFO] Generating examples/comprehensive-demo/report.md (default template)...
[INFO] ✓ examples/comprehensive-demo/report.md generated successfully
[INFO] Generating examples/comprehensive-demo/report-with-sensitive.md (with --show-sensitive)...
[INFO] ✓ examples/comprehensive-demo/report-with-sensitive.md generated successfully
[INFO] Generating examples/comprehensive-demo/report-summary.md (summary template)...
[INFO] ✓ examples/comprehensive-demo/report-summary.md generated successfully
[INFO] All demo artifacts generated successfully

When to Use

• Before running UAT (to ensure artifacts match current code)
• After making changes to templates or rendering logic
• After updating the comprehensive demo plan.json
• When setting up a new development environment