Quality Assurance and Compliance
This repository enforces code quality, prose hygiene, and legal compliance through a suite of vendored, self-contained Python scripts and static checks. The check_file_ceiling.py script ensures no single hand-authored code file exceeds 1,000 lines, preventing architectural sprawl 1. The check_prose_hygiene.py gate scans tracked text files to ban AI-generated prose tells, such as em/en-dashes, decorative emoji, and stock AI-speak phrases, ensuring documentation remains professional and human-authored 2. These gates are validated by test_prose_hygiene.py to prevent regressions in CI 3. Finally, legal compliance is maintained through the DISCLAIMER.md and LICENSE files, which explicitly state the project is unofficial, unsupported, and not affiliated with Dell, while providing standard MIT licensing terms 4 5.
File Size Enforcement
Section titled “File Size Enforcement”The script calculates lines using n_lines = text.count("\n") + 1 and fails if any code file exceeds 1,000 lines 1. It excludes binary files, generated lockfiles (e.g., package-lock.json, go.sum), and common build/cache directories (e.g., node_modules, __pycache__). If a file exceeds the limit, the script exits non-zero and prints the offenders sorted by line count, worst-first.
Prose Hygiene and AI-Speak Detection
Section titled “Prose Hygiene and AI-Speak Detection”To maintain high-quality documentation and comments, tools/check_prose_hygiene.py scans tracked text files for AI-generated prose indicators 2. The script identifies three categories of violations: em/en-dashes, decorative emoji, and stock AI-speak phrases.
Test Validation
Section titled “Test Validation”The tests/test_prose_hygiene.py script serves as the test runner for the prose hygiene gate 3. It ensures that the vendored tools/check_prose_hygiene.py script exists and runs successfully against the repository root. This test is designed to fail if any tracked text file contains banned AI-generated prose tells, thereby blocking regressions in CI or pre-push hooks.
Legal and Compliance Documentation
Section titled “Legal and Compliance Documentation”Legal compliance is enforced through static files DISCLAIMER.md and LICENSE 4 5. The DISCLAIMER.md file explicitly states that the project is unofficial, experimental, and unsupported, with no warranty of any kind 4. It also clarifies that the project is not affiliated with or endorsed by Dell Inc..
The LICENSE file provides the standard MIT License text, granting permission to use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of the software, subject to the inclusion of the copyright notice and permission notice 5. These files ensure that users are aware of the project’s experimental nature and legal boundaries 4 5.
#!/usr/bin/env python3
"""House line-count ceiling check (vendored, stdlib-only, no AI).
VENDORED FILE - do not edit by hand. Regenerate with
``sddc repo audit vendor-ceiling`` from the sddcinfo monorepo. It is a
self-contained port of that monorepo's ``repo_audit`` ceiling logic, using the
identical file classification and ``n_lines = text.count("\n") + 1`` count, so
this gate agrees exactly with ``sddc repo audit ceiling``.
Hand-authored code only (generated lockfiles, binaries, data, config and docs
are excluded). No allowlist - any code file over the ceiling fails, with no
grandfathering. Run it from a repo root (or pass a path); exits non-zero and
prints offenders worst-first when any code file exceeds the ceiling.
"""
from __future__ import annotations
import subprocess
import sys
from pathlib import Path
MAX_FILE_LINES = 1000
# Hand-authored code languages this gate applies to.
CODE_LANGS = {"python", "go", "javascript", "typescript", "astro", "shell", "css", "html"}
_LANG_BY_SUFFIX = {
".py": "python",
".pyi": "python",
".go": "go",
".js": "javascript",
".mjs": "javascript",
".ts": "typescript",
".tsx": "typescript",
".jsx": "javascript",
".astro": "astro",
".sh": "shell",
".bash": "shell",
".css": "css",
".html": "html",#!/usr/bin/env python3
"""Prose-hygiene gate (vendored, stdlib-only, no AI).
VENDORED FILE: do not edit by hand; regenerate from the upstream generator.
Self-contained: scans tracked text files for the AI-generated-prose tells this
project bans -- em/en-dashes, decorative emoji, and stock AI-speak phrases --
and fails if any remain. Run as a pre-commit / pre-push / CI gate so the cruft
can never accrete again.
Two modes:
(default) report offenders and exit non-zero if any are found (the GATE)
--fix deterministically repair the auto-fixable ones in place
(dashes -> hyphen, decorative emoji removed); AI-speak phrases are
reported for manual rewording, never auto-reworded.
A file may opt out of fixing/checking with a line containing the marker
``prose-hygiene: allow`` (for the rare file that legitimately carries the
characters -- e.g. the detector that defines these very patterns).
"""
from __future__ import annotations
import re
import subprocess
import sys
from pathlib import Path
_ALLOW_MARKER = "prose-hygiene: allow"
# Dash family that reads as AI-generated punctuation: em-dash, en-dash,
# horizontal bar, figure dash. All collapse to a plain hyphen.
_DASHES = "—–―‒"
_DASH_RE = re.compile(f"[{_DASHES}]")
# Decorative emoji ranges. Only flagged/stripped where DECORATIVE -- in a
# comment or a docs file -- never in UI markup (HTML/astro/jsx elements) or
# code strings, where emoji are functional (menu glyphs, status marks, icons)
# and removing them would break the product.
_EMOJI_RE = re.compile(
"[\U0001f300-\U0001faff\U00002600-\U000027bf\U0001f1e6-\U0001f1ff\U00002b00-\U00002bff]""""Enforce prose hygiene (no em/en-dashes, decorative emoji, or AI-speak).
VENDORED FILE: do not edit by hand; regenerate from the upstream generator.
Fails if any tracked text file carries the AI-generated-prose tells this project
bans, so CI / pre-push blocks a regression. See tools/check_prose_hygiene.py.
"""
from __future__ import annotations
import subprocess
import sys
from pathlib import Path
def _repo_root() -> Path:
res = subprocess.run(
["git", "rev-parse", "--show-toplevel"],
cwd=str(Path(__file__).resolve().parent),
capture_output=True,
text=True,
check=True,
)
return Path(res.stdout.strip())
def test_no_dashes_emoji_or_ai_speak() -> None:
root = _repo_root()
checker = root / "tools" / "check_prose_hygiene.py"
assert checker.exists(), f"vendored prose-hygiene checker missing: {checker}"
proc = subprocess.run(
[sys.executable, str(checker), str(root)],
capture_output=True,
text=True,
check=False,
)
assert proc.returncode == 0, proc.stdout + proc.stderr
# Disclaimer
This project is unofficial, experimental software provided solely for testing
and evaluation purposes.
- **Unsupported.** No support, maintenance, updates, bug fixes, or service
levels of any kind are provided or implied.
- **No warranty.** The software is provided "AS IS" and "AS AVAILABLE", without
warranty of any kind, whether express, implied, or statutory, including
without limitation the implied warranties of merchantability, fitness for a
particular purpose, title, and non-infringement. The entire risk as to the
quality and performance of the software rests with the user. In no event
shall the authors or copyright holders be liable for any claim, damages, or
other liability, whether in an action of contract, tort, or otherwise,
arising from, out of, or in connection with the software or its use.
- **Not affiliated with or endorsed by Dell.** This project is independent and
is not affiliated with, authorized by, endorsed by, sponsored by, or approved
by Dell Inc., Dell Technologies, or any of their subsidiaries or affiliates.
"Dell", "Dell Technologies", and all related names, marks, and logos are
trademarks or registered trademarks of their respective owners and are used
here for identification and interoperability purposes only.
- **Test use only.** Intended for testing, evaluation, and experimentation in
non-production environments. Use at your own risk.
MIT License
Copyright (c) 2026 sddc.info
Permission is hereby granted, free of charge, to any person obtaining a copy
of this software and associated documentation files (the "Software"), to deal
in the Software without restriction, including without limitation the rights
to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
copies of the Software, and to permit persons to whom the Software is
furnished to do so, subject to the following conditions:
The above copyright notice and this permission notice shall be included in all
copies or substantial portions of the Software.
THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
SOFTWARE.