Public changes compared with the previous published export: 26 files changed. Affected areas: - backend/app: 11 files - dependencies: 5 files - deployment and CI: 3 files - documentation: 2 files - tests: 5 files Changed files: - Updated: "Dockerfile.unraid" - Updated: "README.md" - Updated: "backend/Dockerfile" - Updated: "backend/app/acquisition.py" - Updated: "backend/app/architecture.py" - Updated: "backend/app/git_analysis.py" - Updated: "backend/app/gitea.py" - Updated: "backend/app/jobs.py" - Updated: "backend/app/main.py" - Added: "backend/app/processes.py" - Updated: "backend/app/rules.py" - Updated: "backend/app/scanner.py" - Updated: "backend/app/signals.py" - Updated: "backend/app/store.py" - Updated: "backend/pyproject.toml" - Added: "backend/tests/test_api_responsiveness.py" - Added: "backend/tests/test_processes.py" - Updated: "backend/tests/test_scanner.py" - Updated: "backend/tests/test_signals_v11.py" - Updated: "backend/tests/test_store.py" - Updated: "docker-compose.yml" - Updated: "docs/ARCHITECTURE.md" - Updated: "frontend/package-lock.json" - Updated: "frontend/package.json" - Updated: "package-lock.json" - Updated: "package.json" Export provenance/manifests refreshed; excluded from the change summary. Publish curated RepoPulse source from a251f826238908b156485299061da76482780ed2
96 lines
3.7 KiB
Python
96 lines
3.7 KiB
Python
from functools import lru_cache
|
|
|
|
from .models import Finding, FindingGuidance, Severity
|
|
|
|
_RULES: dict[str, tuple[str, str, str, str]] = {
|
|
"security.secret-assignment": (
|
|
"security remediation",
|
|
"A credential-shaped assignment was found in tracked content.",
|
|
"Move the value to a secret store or runtime environment and rotate it if it was genuine.",
|
|
"high",
|
|
),
|
|
"security.env-committed": (
|
|
"security remediation",
|
|
"A live environment file is tracked, so its contents require deliberate review.",
|
|
"Remove the live file from version control and retain a sanitized .env.example template.",
|
|
"high",
|
|
),
|
|
"testing.none-detected": (
|
|
"test coverage",
|
|
"No conventionally named test source was detected for a repository with source files.",
|
|
"Add a focused deterministic smoke test, or record a repository policy that explains why tests do not apply.",
|
|
"medium",
|
|
),
|
|
"testing.no-ci": (
|
|
"delivery evidence",
|
|
"No repository workflow was found that contains a validation command.",
|
|
"Add a CI validation workflow that runs the repository's deterministic checks.",
|
|
"medium",
|
|
),
|
|
"dependency.no-lockfile": (
|
|
"dependency reproducibility",
|
|
"A JavaScript manifest was found without a lockfile in its package or workspace root.",
|
|
"Commit the package-manager lockfile used by the build.",
|
|
"high",
|
|
),
|
|
"hygiene.missing-gitignore": (
|
|
"repository hygiene",
|
|
"The repository has no root ignore policy.",
|
|
"Add a minimal .gitignore for generated files, local settings and build outputs.",
|
|
"high",
|
|
),
|
|
}
|
|
|
|
|
|
def _default_rule(finding: Finding) -> tuple[str, str, str, str]:
|
|
if finding.code.startswith("dependency."):
|
|
return (
|
|
"dependency hygiene",
|
|
"The dependency declaration has a deterministic hygiene signal.",
|
|
"Review the declared version and lockfile semantics, then make the smallest reproducible correction.",
|
|
"medium",
|
|
)
|
|
if finding.code.startswith("architecture."):
|
|
return (
|
|
"architecture review",
|
|
"The bounded static graph has a structural signal.",
|
|
"Inspect the affected module boundary before planning a contained refactor.",
|
|
"medium",
|
|
)
|
|
return (
|
|
"engineering hygiene",
|
|
"A deterministic repository rule produced this signal.",
|
|
"Review the retained evidence and make the smallest safe correction.",
|
|
"medium",
|
|
)
|
|
|
|
|
|
@lru_cache(maxsize=4096)
|
|
def _guidance(code: str, severity: Severity, deduction: int) -> FindingGuidance:
|
|
"""Guidance depends only on code, severity and deduction; share one immutable instance."""
|
|
|
|
probe = Finding(code=code, category="", severity=severity, message="", deduction=deduction)
|
|
remediation_class, why, action, confidence = _RULES.get(code, _default_rule(probe))
|
|
severity_weight = {Severity.BLOCKER: 700, Severity.WARNING: 400, Severity.INFO: 100}[severity]
|
|
priority = min(1000, severity_weight + deduction * 5)
|
|
rationale = f"{severity.value.title()} signal; {deduction} health-point impact."
|
|
return FindingGuidance(
|
|
remediation_class=remediation_class,
|
|
confidence=confidence,
|
|
why=why,
|
|
recommended_action=action,
|
|
priority=priority,
|
|
priority_rationale=rationale,
|
|
)
|
|
|
|
|
|
def enrich_finding(finding: Finding) -> Finding:
|
|
guidance = _guidance(finding.code, finding.severity, finding.deduction)
|
|
if finding.guidance is guidance:
|
|
return finding
|
|
return finding.model_copy(update={"guidance": guidance})
|
|
|
|
|
|
def enrich_findings(findings: list[Finding]) -> list[Finding]:
|
|
return [enrich_finding(item) for item in findings]
|