Add configuration files and scripts for project standards enforcement
continuous-integration/drone/push Build is failing
continuous-integration/drone/push Build is failing
- Introduced .editorconfig for consistent coding styles. - Added .gitattributes to manage line endings and text attributes. - Created README.md for Git hooks usage and configuration. - Implemented pre-commit hook to enforce executable permissions and LF line endings for shell scripts. - Updated .gitignore to include additional build artifacts and directories. - Enhanced AGENTS.md and Definition of Done documentation with testing standards. - Modified reconciliation scripts to include new configuration files and templates.
This commit is contained in:
@@ -13,6 +13,11 @@ $ErrorActionPreference = 'Stop'
|
||||
|
||||
$agentsTemplate = Join-Path $StandardsRepoPath 'templates/AGENTS.base.md'
|
||||
$dodTemplate = Join-Path $StandardsRepoPath 'templates/DEFINITION_OF_DONE.base.md'
|
||||
$gitIgnoreTemplate = Join-Path $StandardsRepoPath 'templates/.gitignore.base'
|
||||
$gitAttributesTemplate = Join-Path $StandardsRepoPath 'templates/.gitattributes.base'
|
||||
$editorConfigTemplate = Join-Path $StandardsRepoPath 'templates/.editorconfig.base'
|
||||
$preCommitHookTemplate = Join-Path $StandardsRepoPath 'templates/pre-commit.base.sh'
|
||||
$hooksReadmeTemplate = Join-Path $StandardsRepoPath 'templates/.githooks.README.base.md'
|
||||
|
||||
if (-not (Test-Path -Path $agentsTemplate -PathType Leaf)) {
|
||||
throw "AGENTS template not found: $agentsTemplate"
|
||||
@@ -22,6 +27,26 @@ if (-not (Test-Path -Path $dodTemplate -PathType Leaf)) {
|
||||
throw "DoD template not found: $dodTemplate"
|
||||
}
|
||||
|
||||
if (-not (Test-Path -Path $gitIgnoreTemplate -PathType Leaf)) {
|
||||
throw "gitignore template not found: $gitIgnoreTemplate"
|
||||
}
|
||||
|
||||
if (-not (Test-Path -Path $gitAttributesTemplate -PathType Leaf)) {
|
||||
throw "gitattributes template not found: $gitAttributesTemplate"
|
||||
}
|
||||
|
||||
if (-not (Test-Path -Path $editorConfigTemplate -PathType Leaf)) {
|
||||
throw "editorconfig template not found: $editorConfigTemplate"
|
||||
}
|
||||
|
||||
if (-not (Test-Path -Path $preCommitHookTemplate -PathType Leaf)) {
|
||||
throw "pre-commit hook template not found: $preCommitHookTemplate"
|
||||
}
|
||||
|
||||
if (-not (Test-Path -Path $hooksReadmeTemplate -PathType Leaf)) {
|
||||
throw "hooks readme template not found: $hooksReadmeTemplate"
|
||||
}
|
||||
|
||||
if ($IntervalSeconds -lt 5) {
|
||||
throw 'IntervalSeconds must be >= 5.'
|
||||
}
|
||||
@@ -63,23 +88,41 @@ function Ensure-FileFromTemplate {
|
||||
return 'updated'
|
||||
}
|
||||
|
||||
function Ensure-GitIgnoreBuildEntry {
|
||||
function Ensure-GitIgnoreEntriesFromTemplate {
|
||||
param(
|
||||
[string]$TemplatePath,
|
||||
[string]$GitIgnorePath,
|
||||
[switch]$OnlyCheck
|
||||
)
|
||||
|
||||
$requiredEntries = Get-Content -Path $TemplatePath | Where-Object {
|
||||
$_.Trim() -and -not $_.Trim().StartsWith('#')
|
||||
}
|
||||
|
||||
if (-not (Test-Path -Path $GitIgnorePath -PathType Leaf)) {
|
||||
if ($OnlyCheck) {
|
||||
return 'drift'
|
||||
}
|
||||
|
||||
Set-Content -Path $GitIgnorePath -Value '.build/'
|
||||
return 'updated'
|
||||
New-Item -ItemType File -Path $GitIgnorePath | Out-Null
|
||||
}
|
||||
|
||||
$lines = Get-Content -Path $GitIgnorePath
|
||||
if ($lines -contains '.build/') {
|
||||
|
||||
$missingEntry = $false
|
||||
foreach ($entry in $requiredEntries) {
|
||||
if ($lines -contains $entry) {
|
||||
continue
|
||||
}
|
||||
|
||||
$missingEntry = $true
|
||||
if (-not $OnlyCheck) {
|
||||
Add-Content -Path $GitIgnorePath -Value $entry
|
||||
$lines += $entry
|
||||
}
|
||||
}
|
||||
|
||||
if (-not $missingEntry) {
|
||||
return 'ok'
|
||||
}
|
||||
|
||||
@@ -87,7 +130,6 @@ function Ensure-GitIgnoreBuildEntry {
|
||||
return 'drift'
|
||||
}
|
||||
|
||||
Add-Content -Path $GitIgnorePath -Value '.build/'
|
||||
return 'updated'
|
||||
}
|
||||
|
||||
@@ -110,20 +152,44 @@ function Invoke-ReconcileOnce {
|
||||
$agentsTarget = Join-Path $repoPath 'AGENTS.md'
|
||||
$dodTarget = Join-Path (Join-Path $repoPath 'docs') 'DEFINITION_OF_DONE.md'
|
||||
$gitIgnoreTarget = Join-Path $repoPath '.gitignore'
|
||||
$gitAttributesTarget = Join-Path $repoPath '.gitattributes'
|
||||
$editorConfigTarget = Join-Path $repoPath '.editorconfig'
|
||||
$preCommitHookTarget = Join-Path (Join-Path $repoPath '.githooks') 'pre-commit'
|
||||
$hooksReadmeTarget = Join-Path (Join-Path $repoPath '.githooks') 'README.md'
|
||||
|
||||
$summary.scanned++
|
||||
|
||||
$agentsState = Ensure-FileFromTemplate -Template $agentsTemplate -Target $agentsTarget -OnlyCheck:$OnlyCheck
|
||||
$dodState = Ensure-FileFromTemplate -Template $dodTemplate -Target $dodTarget -OnlyCheck:$OnlyCheck
|
||||
$gitIgnoreState = Ensure-GitIgnoreBuildEntry -GitIgnorePath $gitIgnoreTarget -OnlyCheck:$OnlyCheck
|
||||
$gitAttributesState = Ensure-FileFromTemplate -Template $gitAttributesTemplate -Target $gitAttributesTarget -OnlyCheck:$OnlyCheck
|
||||
$editorConfigState = Ensure-FileFromTemplate -Template $editorConfigTemplate -Target $editorConfigTarget -OnlyCheck:$OnlyCheck
|
||||
$preCommitHookState = Ensure-FileFromTemplate -Template $preCommitHookTemplate -Target $preCommitHookTarget -OnlyCheck:$OnlyCheck
|
||||
$hooksReadmeState = Ensure-FileFromTemplate -Template $hooksReadmeTemplate -Target $hooksReadmeTarget -OnlyCheck:$OnlyCheck
|
||||
$gitIgnoreState = Ensure-GitIgnoreEntriesFromTemplate -TemplatePath $gitIgnoreTemplate -GitIgnorePath $gitIgnoreTarget -OnlyCheck:$OnlyCheck
|
||||
|
||||
if ($agentsState -eq 'updated' -or $dodState -eq 'updated' -or $gitIgnoreState -eq 'updated') {
|
||||
if (
|
||||
$agentsState -eq 'updated' -or
|
||||
$dodState -eq 'updated' -or
|
||||
$gitAttributesState -eq 'updated' -or
|
||||
$editorConfigState -eq 'updated' -or
|
||||
$preCommitHookState -eq 'updated' -or
|
||||
$hooksReadmeState -eq 'updated' -or
|
||||
$gitIgnoreState -eq 'updated'
|
||||
) {
|
||||
$summary.updated++
|
||||
Write-Host "UPDATED: $repoPath"
|
||||
continue
|
||||
}
|
||||
|
||||
if ($agentsState -eq 'drift' -or $dodState -eq 'drift' -or $gitIgnoreState -eq 'drift') {
|
||||
if (
|
||||
$agentsState -eq 'drift' -or
|
||||
$dodState -eq 'drift' -or
|
||||
$gitAttributesState -eq 'drift' -or
|
||||
$editorConfigState -eq 'drift' -or
|
||||
$preCommitHookState -eq 'drift' -or
|
||||
$hooksReadmeState -eq 'drift' -or
|
||||
$gitIgnoreState -eq 'drift'
|
||||
) {
|
||||
$summary.drift++
|
||||
Write-Host "DRIFT: $repoPath"
|
||||
continue
|
||||
|
||||
Regular → Executable
+68
-13
@@ -69,6 +69,11 @@ fi
|
||||
|
||||
AGENTS_TEMPLATE="$STANDARDS_REPO/templates/AGENTS.base.md"
|
||||
DOD_TEMPLATE="$STANDARDS_REPO/templates/DEFINITION_OF_DONE.base.md"
|
||||
GITIGNORE_TEMPLATE="$STANDARDS_REPO/templates/.gitignore.base"
|
||||
GITATTRIBUTES_TEMPLATE="$STANDARDS_REPO/templates/.gitattributes.base"
|
||||
EDITORCONFIG_TEMPLATE="$STANDARDS_REPO/templates/.editorconfig.base"
|
||||
PRECOMMIT_TEMPLATE="$STANDARDS_REPO/templates/pre-commit.base.sh"
|
||||
HOOKS_README_TEMPLATE="$STANDARDS_REPO/templates/.githooks.README.base.md"
|
||||
|
||||
if [ ! -f "$AGENTS_TEMPLATE" ]; then
|
||||
echo "AGENTS template not found: $AGENTS_TEMPLATE" >&2
|
||||
@@ -80,6 +85,31 @@ if [ ! -f "$DOD_TEMPLATE" ]; then
|
||||
exit 1
|
||||
fi
|
||||
|
||||
if [ ! -f "$GITIGNORE_TEMPLATE" ]; then
|
||||
echo "gitignore template not found: $GITIGNORE_TEMPLATE" >&2
|
||||
exit 1
|
||||
fi
|
||||
|
||||
if [ ! -f "$GITATTRIBUTES_TEMPLATE" ]; then
|
||||
echo "gitattributes template not found: $GITATTRIBUTES_TEMPLATE" >&2
|
||||
exit 1
|
||||
fi
|
||||
|
||||
if [ ! -f "$EDITORCONFIG_TEMPLATE" ]; then
|
||||
echo "editorconfig template not found: $EDITORCONFIG_TEMPLATE" >&2
|
||||
exit 1
|
||||
fi
|
||||
|
||||
if [ ! -f "$PRECOMMIT_TEMPLATE" ]; then
|
||||
echo "pre-commit hook template not found: $PRECOMMIT_TEMPLATE" >&2
|
||||
exit 1
|
||||
fi
|
||||
|
||||
if [ ! -f "$HOOKS_README_TEMPLATE" ]; then
|
||||
echo "hooks readme template not found: $HOOKS_README_TEMPLATE" >&2
|
||||
exit 1
|
||||
fi
|
||||
|
||||
hash_or_missing() {
|
||||
path=$1
|
||||
if [ ! -f "$path" ]; then
|
||||
@@ -116,8 +146,11 @@ ensure_file() {
|
||||
printf "%s" "updated"
|
||||
}
|
||||
|
||||
ensure_gitignore_build_entry() {
|
||||
gitignore_path=$1
|
||||
ensure_gitignore_entries_from_template() {
|
||||
template_path=$1
|
||||
gitignore_path=$2
|
||||
|
||||
missing=0
|
||||
|
||||
if [ ! -f "$gitignore_path" ]; then
|
||||
if [ "$CHECK_ONLY" -eq 1 ]; then
|
||||
@@ -125,23 +158,37 @@ ensure_gitignore_build_entry() {
|
||||
return 0
|
||||
fi
|
||||
|
||||
printf '%s\n' '.build/' > "$gitignore_path"
|
||||
printf "%s" "updated"
|
||||
return 0
|
||||
: > "$gitignore_path"
|
||||
fi
|
||||
|
||||
if grep -Fqx '.build/' "$gitignore_path"; then
|
||||
while IFS= read -r entry; do
|
||||
[ -n "$entry" ] || continue
|
||||
case "$entry" in
|
||||
\#*)
|
||||
continue
|
||||
;;
|
||||
esac
|
||||
|
||||
if grep -Fqx "$entry" "$gitignore_path"; then
|
||||
continue
|
||||
fi
|
||||
|
||||
missing=1
|
||||
if [ "$CHECK_ONLY" -ne 1 ]; then
|
||||
printf '%s\n' "$entry" >> "$gitignore_path"
|
||||
fi
|
||||
done < "$template_path"
|
||||
|
||||
if [ "$missing" -eq 0 ]; then
|
||||
printf "%s" "ok"
|
||||
return 0
|
||||
fi
|
||||
|
||||
if [ "$CHECK_ONLY" -eq 1 ]; then
|
||||
printf "%s" "drift"
|
||||
return 0
|
||||
else
|
||||
printf "%s" "updated"
|
||||
fi
|
||||
|
||||
printf '\n%s\n' '.build/' >> "$gitignore_path"
|
||||
printf "%s" "updated"
|
||||
}
|
||||
|
||||
run_once() {
|
||||
@@ -159,19 +206,27 @@ run_once() {
|
||||
|
||||
agents_target="$repo/AGENTS.md"
|
||||
dod_target="$repo/docs/DEFINITION_OF_DONE.md"
|
||||
gitattributes_target="$repo/.gitattributes"
|
||||
editorconfig_target="$repo/.editorconfig"
|
||||
precommit_target="$repo/.githooks/pre-commit"
|
||||
hooks_readme_target="$repo/.githooks/README.md"
|
||||
gitignore_target="$repo/.gitignore"
|
||||
|
||||
agents_state=$(ensure_file "$AGENTS_TEMPLATE" "$agents_target")
|
||||
dod_state=$(ensure_file "$DOD_TEMPLATE" "$dod_target")
|
||||
gitignore_state=$(ensure_gitignore_build_entry "$gitignore_target")
|
||||
gitattributes_state=$(ensure_file "$GITATTRIBUTES_TEMPLATE" "$gitattributes_target")
|
||||
editorconfig_state=$(ensure_file "$EDITORCONFIG_TEMPLATE" "$editorconfig_target")
|
||||
precommit_state=$(ensure_file "$PRECOMMIT_TEMPLATE" "$precommit_target")
|
||||
hooks_readme_state=$(ensure_file "$HOOKS_README_TEMPLATE" "$hooks_readme_target")
|
||||
gitignore_state=$(ensure_gitignore_entries_from_template "$GITIGNORE_TEMPLATE" "$gitignore_target")
|
||||
|
||||
if [ "$agents_state" = "updated" ] || [ "$dod_state" = "updated" ] || [ "$gitignore_state" = "updated" ]; then
|
||||
if [ "$agents_state" = "updated" ] || [ "$dod_state" = "updated" ] || [ "$gitattributes_state" = "updated" ] || [ "$editorconfig_state" = "updated" ] || [ "$precommit_state" = "updated" ] || [ "$hooks_readme_state" = "updated" ] || [ "$gitignore_state" = "updated" ]; then
|
||||
updated=$((updated + 1))
|
||||
echo "UPDATED: $repo"
|
||||
continue
|
||||
fi
|
||||
|
||||
if [ "$agents_state" = "drift" ] || [ "$dod_state" = "drift" ] || [ "$gitignore_state" = "drift" ]; then
|
||||
if [ "$agents_state" = "drift" ] || [ "$dod_state" = "drift" ] || [ "$gitattributes_state" = "drift" ] || [ "$editorconfig_state" = "drift" ] || [ "$precommit_state" = "drift" ] || [ "$hooks_readme_state" = "drift" ] || [ "$gitignore_state" = "drift" ]; then
|
||||
drift=$((drift + 1))
|
||||
echo "DRIFT: $repo"
|
||||
continue
|
||||
|
||||
Reference in New Issue
Block a user