feat(scripts): add Get-StandardTimestamp utility to CIHelpers module

[AhmedMustafa249]

Description

Added a Get-StandardTimestamp function to CIHelpers.psm1 that returns the current UTC time as an ISO 8601 string (2025-01-15T18:30:00.0000000Z). Five different timestamp expressions existed across linting and security scripts with no shared utility, making cross-script log correlation unreliable. This function provides a single, authoritative source for consistent, timezone-unambiguous timestamps across all scripts.

Related Issue(s)

Closes #993

Type of Change

Select all that apply:

Code & Documentation:

• Bug fix (non-breaking change fixing an issue)
• New feature (non-breaking change adding functionality)
• Breaking change (fix or feature causing existing functionality to change)
• Documentation update

Infrastructure & Configuration:

• GitHub Actions workflow
• Linting configuration (markdown, PowerShell, etc.)
• Security configuration
• DevContainer configuration
• Dependency update

Other:

• Script/automation (.ps1, .sh, .py)
• Other (please describe):

Testing

All validation was performed:

• npm run lint:ps — Passed. All PowerShell files pass PSScriptAnalyzer checks with no issues.
• npm run test:ps — Passed. 73/73 Pester tests pass, including all 4 new Get-StandardTimestamp tests:
  • Returns a string
  • Returns a non-empty value
  • Matches ISO 8601 UTC format ending in Z
  • Returns monotonically increasing timestamps on consecutive calls
• Security analysis: No sensitive data, new dependencies, or privilege scope changes detected.
• No manual testing required for this change; the function has no external side effects or I/O.

Checklist

Required Checks

• Documentation is updated (if applicable)
• Files follow existing naming conventions
• Changes are backwards compatible (if applicable)
• Tests added for new functionality (if applicable)

Required Automated Checks

The following validation commands must pass before merging:

• Markdown linting: npm run lint:md
• Spell checking: npm run spell-check
• Frontmatter validation: npm run lint:frontmatter
• Skill structure validation: npm run validate:skills
• Link validation: npm run lint:md-links
• PowerShell analysis: npm run lint:ps
• Plugin freshness: npm run plugin:generate

Security Considerations

• This PR does not contain any sensitive or NDA information
• Any new dependencies have been reviewed for security issues (N/A — no new dependencies)
• Security-related scripts follow the principle of least privilege (N/A — no security script changes)

Additional Notes

This function is a prerequisite for issue #1000 (Standardize timestamp in SecurityHelpers.psm1 to use Get-StandardTimestamp), which will be addressed in a follow-up PR.

[codecov-commenter]

Codecov Report

✅ All modified and coverable lines are covered by tests.
✅ Project coverage is 86.90%. Comparing base (fdf1bcf) to head (3997f19).

Additional details and impacted files

@@            Coverage Diff             @@
##             main    #1126      +/-   ##
==========================================
- Coverage   86.91%   86.90%   -0.01%     
==========================================
  Files          59       59              
  Lines        8751     8752       +1     
==========================================
  Hits         7606     7606              
- Misses       1145     1146       +1     

Flag	Coverage Δ
pester	85.34% <100.00%> (-0.02%)	⬇️

Flags with carried forward coverage won't be shown. Click here to find out more.

Files with missing lines	Coverage Δ
scripts/lib/Modules/CIHelpers.psm1	97.88% <100.00%> (+0.01%)	⬆️

... and 1 file with indirect coverage changes

🚀 New features to boost your workflow:

• ❄️ Test Analytics: Detect flaky tests, report on failures, and find test suite problems.

[WilliamBerryiii]

Thank you for this contribution, @AhmedMustafa249! 🎉 Your Get-StandardTimestamp utility centralizes the scattered ISO 8601 timestamp logic across CIHelpers, giving us a single, well-tested function the rest of the codebase can converge on. We appreciate the thorough test coverage and clean implementation.

We pushed one small tweak to the monotonicity test — replacing Start-Sleep with a mocked Get-Date so the assertion is deterministic and the test suite stays fast. Everything passes cleanly.

Thank you for the continued contributions to the project!