Skip to content

feat: add DevPath Sentinel foundation and dataset validator#1296

Open
jyotish6699 wants to merge 3 commits into
komalharshita:mainfrom
jyotish6699:feat/devpath-sentinel
Open

feat: add DevPath Sentinel foundation and dataset validator#1296
jyotish6699 wants to merge 3 commits into
komalharshita:mainfrom
jyotish6699:feat/devpath-sentinel

Conversation

@jyotish6699

@jyotish6699 jyotish6699 commented Jul 19, 2026

Copy link
Copy Markdown
Contributor

Summary

Closes #1295

This PR introduces the initial foundation for DevPath Sentinel, a lightweight developer utility for validating repository integrity.

The first phase focuses on dataset validation and provides a structured validation report to help contributors identify common repository issues before opening a pull request.

The implementation is intentionally modular so additional validators can be added in future contributions without changing the overall architecture.


What this PR includes

DevPath Sentinel foundation

  • Added the tools/sentinel package
  • Added a command-line interface for running repository validations
  • Added a reusable reporting module
  • Added a shared ValidationResult model

Dataset Validator

Implemented validation for:

  • JSON dataset loading
  • Duplicate project ID detection
  • Duplicate project title detection
  • Missing required fields
  • Empty required fields
  • Starter code reference validation (reported as warnings)

Repository Validation Report

Added a console report that summarizes:

  • Projects scanned
  • Validation checks
  • Warning count
  • Error count
  • Overall repository validation status

Example output:

DevPath Sentinel
Repository Health & Integrity Validator

Running Dataset Validator...

Projects scanned : 32

✓ Duplicate IDs............... PASS
✓ Duplicate Titles............ PASS
✓ Required Fields............. PASS
✓ Empty Fields................ PASS
⚠ Starter Code............... WARN (5)

Projects scanned : 32
Checks passed    : 4
Warnings         : 5
Errors           : 0

Status : PASSED WITH WARNINGS

Documentation

Updated project documentation to introduce DevPath Sentinel:

  • Added usage instructions to README.md
  • Updated CONTRIBUTING.md with repository validation guidance for contributors
  • Added tools/sentinel/README.md documenting the current DevPath Sentinel utility
  • Updated CHANGELOG.md to record the introduction of DevPath Sentinel

Tests

Added unit tests covering:

  • Valid dataset
  • Duplicate project IDs
  • Duplicate project titles
  • Missing required fields
  • Empty required fields
  • Missing starter code warnings
  • Invalid JSON
  • Missing dataset file

Notes

This PR focuses on establishing the DevPath Sentinel foundation and implementing the Dataset Validator only.

Additional validators such as:

  • Starter Code Validator
  • Route Validator
  • Template Validator
  • Repository Summary

can be implemented as follow-up contributions using the same architecture.


Testing

Implemented and verified:

python -m tools.sentinel.cli
pytest tests/test_sentinel_dataset_validator.py

The dataset validator tests pass successfully, and the project documentation has been updated to describe the current DevPath Sentinel workflow and usage.

Screenshots

Screenshot from 2026-07-19 14-12-30

Create the initial DevPath Sentinel structure with a CLI entry point, report utilities, version metadata, and validator package. This establishes the foundation for future repository health validators without adding validation logic.
Add the DevPath Sentinel framework with a dataset validator, reporting support, structured validation results, and comprehensive unit tests covering validation rules and error handling.
@vercel

vercel Bot commented Jul 19, 2026

Copy link
Copy Markdown

@jyotish6699 is attempting to deploy a commit to the komalsony234-1530's projects Team on Vercel.

A member of the Team first needs to authorize it.

Document the DevPath Sentinel developer tool in the project documentation, including contributor guidance, usage instructions, changelog entry, and tool-specific documentation.
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Projects

None yet

Development

Successfully merging this pull request may close these issues.

[Feature]: Add DevPath Sentinel foundation for repository dataset validation

1 participant