← Files Codex SecurityARCHIVED FILE
scripts/workbench_constants.py
3.1 KB · Nov 18, 2026 · 06:11 UTC
"""Shared constants for the Codex Security workbench."""
import argparse
MODES = ("diff", "standard", "deep")
DIFF_TARGET_KINDS = ("working_tree", "commit", "range")
PHASES = ("preflight", "threat_model", "discovery", "validation", "attack_path", "reporting")
PHASE_PROGRESS_UNITS = (
"checks",
"threat_surfaces",
"review_receipts",
"candidate_findings",
"validated_findings",
"report_artifacts",
)
FINDING_SEVERITIES = ("critical", "high", "medium", "low", "informational")
FINDING_STATUSES = ("open", "closed")
FINDING_CLOSE_REASONS = ("already_fixed", "wont_fix", "false_positive")
REMEDIATION_UPDATE_STATES = ("generated", "applied", "verifying", "verified", "failed")
EXPORT_FORMATS = ("csv", "json", "sarif")
ARTIFACTS = {
"findings": "findings.json",
"manifest": "scan-manifest.json",
"markdownReport": "report.md",
}
SQLITE_RETRY_ATTEMPTS = 5
CLAIM_LEASE_SECONDS = 120
DELIVERED_ACTION_LEASE_SECONDS = 900
PATCH_PREVIEW_BYTES = 16_000
FINDINGS_RESULT_LIMIT = 20
FINDINGS_PAGE_MAX = 20
FINDING_DETAILS_PREVIEW_BYTES = 16_000
FINDING_ROOT_CAUSE_PREVIEW_BYTES = 2_000
FINDING_VALIDATION_PREVIEW_BYTES = 3_000
FINDING_ATTACK_PATH_PREVIEW_BYTES = 4_000
FINDING_CODE_EVIDENCE_LIMIT = 4
FINDING_CODE_EVIDENCE_SNIPPET_BYTES = 1_500
FINDING_EVIDENCE_EXCERPT_BYTES = 8_000
FINDING_LOCATION_ORDER_SQL = "CASE WHEN role = 'root_control' THEN 0 ELSE 1 END, sort_order"
# The outer query binds finding_occurrences as occurrences.
PRIMARY_FINDING_LOCATION_SQL = f"""
FROM finding_locations
WHERE occurrence_id = occurrences.id
ORDER BY {FINDING_LOCATION_ORDER_SQL}
LIMIT 1
"""
FINDING_LOCATIONS_LIMIT = 8
FINDING_TITLE_BYTES = 512
FINDING_SUMMARY_BYTES = 2_000
FINDING_REMEDIATION_BYTES = 2_000
FINDING_LOCATION_PATH_BYTES = 2_048
FINDING_LOCATION_ROLE_BYTES = 128
FINDING_ABSOLUTE_PATH_BYTES = 4_096
FINDING_LEVEL_BYTES = 128
GIT_REPOSITORY_ENVIRONMENT = (
"GIT_ALTERNATE_OBJECT_DIRECTORIES",
"GIT_CEILING_DIRECTORIES",
"GIT_COMMON_DIR",
"GIT_DIR",
"GIT_DISCOVERY_ACROSS_FILESYSTEM",
"GIT_GLOB_PATHSPECS",
"GIT_ICASE_PATHSPECS",
"GIT_INDEX_FILE",
"GIT_NAMESPACE",
"GIT_OBJECT_DIRECTORY",
"GIT_WORK_TREE",
)
EMPTY_GIT_TREE = "4b825dc642cb6eb9a060e54bf8d69288fbee4904"
EMPTY_GIT_TREES = {
"sha1": EMPTY_GIT_TREE,
"sha256": "6ef19b41225c5369f1c104d45d8d85efa9b057b53b14b4b9b939dd74decc5321",
}
def optional_text(value: str | None, *, maximum: int | None = None) -> str | None:
"""Strip surrounding whitespace, return None for blank text, and enforce the character limit."""
if value is None:
return None
normalized = value.strip()
if maximum is not None and len(normalized) > maximum:
raise SystemExit(f"Text value must be no longer than {maximum} characters.")
return normalized or None
def positive_int(value: str) -> int:
"""Parse a CLI count and reject values below one with an argparse validation error."""
parsed = int(value)
if parsed < 1:
raise argparse.ArgumentTypeError("expected a positive integer")
return parsed
if __name__ == "__main__":
argparse.ArgumentParser(description=__doc__).parse_args()
SHA-256: 8cc007a47d6f687ea2860896adff1e51eb98ae6e1811b370c53e36f37fe9dde3