Skip to content

Issue 29: cross-repository quality policy and context accuracy - #59

Merged
DerekCorniello merged 11 commits into
mainfrom
audit/issue-29-stack
Aug 29, 2026
Merged

Issue 29: cross-repository quality policy and context accuracy#59
DerekCorniello merged 11 commits into
mainfrom
audit/issue-29-stack

Conversation

@DerekCorniello

Copy link
Copy Markdown
Contributor

Local Derek-authored remediation stack for issue 29. Adds scoped encoding/documentation policy, generated-artifact contracts, repository maps, guidance accuracy, and context checks.

@greptile-apps

greptile-apps Bot commented Aug 29, 2026

Copy link
Copy Markdown

Greptile Summary

The PR introduces a data-driven documentation and encoding quality gate while updating cross-repository architecture, ownership, governance, and artifact-generation guidance.

  • Runs local Markdown-link, UTF-8, and scoped ASCII validation in CI.
  • Defines repository-specific encoding scopes and generated-artifact contracts.
  • Updates ecosystem maps and decisions for source-pinned runtime consumption, syntax ownership, and the examples repository.
  • Corrects the previously reported encoding-precedence and linked-image parsing issues.

Confidence Score: 5/5

The PR appears safe to merge.

No blocking failure remains; the current code resolves all three previously reported documentation-checker issues.

Important Files Changed

Filename Overview
scripts/ci/check-docs.py Implements tracked-file UTF-8 checks, scoped ASCII enforcement, and local Markdown-target validation; the displayed prior parser and precedence defects are corrected.
scripts/tests/test_check_docs.py Adds focused regression coverage for encoding-policy validation, root glob matching, overlapping ASCII scopes, and linked-image targets.
docs/encoding-policy.json Defines validated per-repository ASCII scopes and documented Unicode allowances.
.github/workflows/sonar.yml Adds the documentation quality checker to the workflow lint job.
docs/generated-artifacts.yml Records generated artifacts together with their source, pinned producer, regeneration command, and drift check.
AGENTS.md Reframes repository guidance around ownership accuracy, scoped encoding rules, and the new documentation quality gate.
ARCHITECTURE.md Updates the ecosystem map with mux-examples, mux-context, and the canonical shared syntax-matrix location.

Reviews (3): Last reviewed commit: "Split documentation policy checks by res..." | Re-trigger Greptile

Comment thread scripts/ci/check-docs.py Outdated
Comment thread scripts/ci/check-docs.py
Comment thread scripts/tests/test_check_docs.py
@sonarqubecloud

Copy link
Copy Markdown

@DerekCorniello
DerekCorniello marked this pull request as ready for review August 29, 2026 21:50
@DerekCorniello
DerekCorniello enabled auto-merge (squash) August 29, 2026 21:50
@DerekCorniello
DerekCorniello merged commit 61c1262 into main Aug 29, 2026
4 checks passed
@DerekCorniello
DerekCorniello deleted the audit/issue-29-stack branch August 29, 2026 22:06
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant