timecs 2.0.0__py3-none-any.whl

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (94) hide show
  1. app.py +3014 -0
  2. ast_scanner.py +36187 -0
  3. banner.py +146 -0
  4. ci_reporter.py +570 -0
  5. cli.py +2347 -0
  6. config_loader.py +307 -0
  7. cross_file_engine.py +1781 -0
  8. delivery_models.py +145 -0
  9. delivery_repository.py +78 -0
  10. diff_scan.py +127 -0
  11. durable_delivery_sink.py +103 -0
  12. event_bus.py +155 -0
  13. event_publisher.py +345 -0
  14. event_taxonomy.py +313 -0
  15. function_summarizer.py +354 -0
  16. html_auditor.py +274 -0
  17. iac_auditor.py +400 -0
  18. in_app_adapter.py +115 -0
  19. js_scanner.py +895 -0
  20. manifest_parser.py +960 -0
  21. master_rules_bank.py +389 -0
  22. notification_models.py +346 -0
  23. notification_policy.py +309 -0
  24. notification_repository.py +118 -0
  25. notification_routes.py +394 -0
  26. notification_service.py +199 -0
  27. osv_client.py +437 -0
  28. remediation/__init__.py +39 -0
  29. remediation/base.py +102 -0
  30. remediation/contracts.py +196 -0
  31. remediation/cwe1188_binding.py +78 -0
  32. remediation/cwe1336_jinja.py +91 -0
  33. remediation/cwe22_path_traversal.py +348 -0
  34. remediation/cwe295_ssl.py +87 -0
  35. remediation/cwe327_weak_hash.py +78 -0
  36. remediation/cwe377_tempfile.py +77 -0
  37. remediation/cwe489_debug.py +80 -0
  38. remediation/cwe502_yaml.py +89 -0
  39. remediation/cwe614_cookie.py +91 -0
  40. remediation/cwe78_cmdi.py +415 -0
  41. remediation/cwe798_credentials.py +153 -0
  42. remediation/cwe89_sqli.py +425 -0
  43. remediation/cwe916_password_hash.py +131 -0
  44. remediation/cwe95_eval.py +77 -0
  45. remediation/dispatcher.py +114 -0
  46. remediation/orchestrator.py +541 -0
  47. remediation/patch_engine.py +213 -0
  48. remediation/verification.py +253 -0
  49. rule_engine.py +1535 -0
  50. sarif_adapter.py +719 -0
  51. sarif_exporter.py +88 -0
  52. sca_reachability/__init__.py +28 -0
  53. sca_reachability/ast_analyzer.py +366 -0
  54. sca_reachability/call_graph.py +203 -0
  55. sca_reachability/contracts.py +365 -0
  56. sca_reachability/dist_import_map.py +46 -0
  57. sca_reachability/engine.py +603 -0
  58. sca_reachability/resolver.py +169 -0
  59. scanners/__init__.py +70 -0
  60. scanners/container_scanner.py +323 -0
  61. scanners/cve_index.py +521 -0
  62. scanners/iac_scanner.py +328 -0
  63. scanners/sbom.py +183 -0
  64. scanners/sca_scanner.py +667 -0
  65. scanners/secret_scanner.py +345 -0
  66. scanners/yaml_lite.py +217 -0
  67. secret_filters.py +435 -0
  68. secret_scanner.py +943 -0
  69. sqlite_delivery_repository.py +277 -0
  70. sqlite_notification_repository.py +441 -0
  71. ssrf_guard.py +276 -0
  72. staged_scanner.py +492 -0
  73. suppression_resolver.py +282 -0
  74. symbol_indexer.py +424 -0
  75. tcs/__init__.py +1 -0
  76. tcs/analysis/__init__.py +1 -0
  77. tcs/analysis/def_use.py +408 -0
  78. tcs/analysis/function_contracts.py +290 -0
  79. tcs/parallel_analyzer.py +276 -0
  80. tcs/parallel_scanner.py +630 -0
  81. tcs/treesitter_packer.py +1446 -0
  82. tcs_cli.py +2086 -0
  83. tcs_config.py +218 -0
  84. tcs_gui.py +2123 -0
  85. timecs-2.0.0.dist-info/METADATA +142 -0
  86. timecs-2.0.0.dist-info/RECORD +94 -0
  87. timecs-2.0.0.dist-info/WHEEL +5 -0
  88. timecs-2.0.0.dist-info/entry_points.txt +4 -0
  89. timecs-2.0.0.dist-info/licenses/LICENSE +201 -0
  90. timecs-2.0.0.dist-info/top_level.txt +49 -0
  91. version_matcher.py +934 -0
  92. webhook_adapter.py +495 -0
  93. webhook_client.py +483 -0
  94. webhook_formatters.py +245 -0
@@ -0,0 +1,131 @@
1
+ """
2
+ TimeCodeSecurity - Vector D CWE-916 Weak Password Hash Transformer.
3
+ Implements deterministic AST-guided remediation replacing fast password hashes
4
+ (md5/sha1/sha256/sha512) with the memory-hard hashlib.scrypt KDF.
5
+
6
+ CWE-916 is about insufficient computational effort for password storage, so the
7
+ md5->sha256 swap used by the CWE-327 transformer cannot clear it: sha256 remains
8
+ a fast hash. scrypt is the minimal deterministic rewrite that removes the finding.
9
+ """
10
+
11
+ from typing import Any, Dict, Optional, Tuple
12
+ import ast
13
+
14
+ from remediation.base import BaseRemediationTransformer
15
+ from remediation.contracts import RemediationRule, PatchStatus
16
+
17
+ WEAK_HASH_ATTRS = ("md5", "sha1", "sha256", "sha512")
18
+ SALT_PLACEHOLDER = "change-me-static-salt"
19
+
20
+
21
+ class Cwe916PasswordHashTransformer(BaseRemediationTransformer):
22
+ """
23
+ Deterministic AST transformer for CWE-916 (and its CWE-759 unsalted variant).
24
+ Rewrites hashlib.<weak>(<password>) into
25
+ hashlib.scrypt(<password>, salt=b"...", n=16384, r=8, p=1), dropping a
26
+ trailing .hexdigest() since scrypt already returns bytes.
27
+ """
28
+
29
+ @property
30
+ def rule(self) -> RemediationRule:
31
+ return RemediationRule.PASSWORD_HASH_KDF
32
+
33
+ def can_transform(
34
+ self,
35
+ tree: ast.AST,
36
+ finding: Dict[str, Any],
37
+ source_code: str
38
+ ) -> bool:
39
+ return self._find_weak_hash_call(tree, int(finding.get("line_number", 0))) is not None
40
+
41
+ def transform(
42
+ self,
43
+ tree: ast.AST,
44
+ finding: Dict[str, Any],
45
+ source_code: str
46
+ ) -> Tuple[PatchStatus, Optional[str], Optional[str], Tuple[str, ...]]:
47
+ line_number = int(finding.get("line_number", 0))
48
+
49
+ call_node = self._find_weak_hash_call(tree, line_number)
50
+ if not call_node:
51
+ return (PatchStatus.UNSUPPORTED_CWE, None, None, ("Weak password hash call not found",))
52
+
53
+ if not call_node.args:
54
+ return (PatchStatus.UNSUPPORTED_CWE, None, None, ("Hash call has no password argument",))
55
+
56
+ password_arg = call_node.args[0]
57
+
58
+ call_node.func = ast.Attribute(
59
+ value=ast.Name(id="hashlib", ctx=ast.Load()),
60
+ attr="scrypt",
61
+ ctx=ast.Load(),
62
+ )
63
+ call_node.args = [password_arg]
64
+ call_node.keywords = [
65
+ ast.keyword(arg="salt", value=ast.Constant(value=SALT_PLACEHOLDER.encode())),
66
+ ast.keyword(arg="n", value=ast.Constant(value=16384)),
67
+ ast.keyword(arg="r", value=ast.Constant(value=8)),
68
+ ast.keyword(arg="p", value=ast.Constant(value=1)),
69
+ ]
70
+
71
+ parent = self._find_digest_parent(tree, call_node)
72
+ if parent is not None:
73
+ self._replace_node(tree, parent, call_node)
74
+
75
+ try:
76
+ patched_source = ast.unparse(ast.fix_missing_locations(tree))
77
+ except Exception as e:
78
+ return (PatchStatus.FAILED_SYNTAX, None, None, (f"AST unparse failed: {e}",))
79
+
80
+ snippet = self.patched_statement_snippet(tree, source_code, line_number) or ""
81
+
82
+ limitations = (
83
+ "A static placeholder salt is emitted; derive a per-user salt with "
84
+ "os.urandom(16) and store it alongside the hash before production use.",
85
+ )
86
+ return (PatchStatus.SUCCESS, patched_source, snippet, limitations)
87
+
88
+ def _find_weak_hash_call(
89
+ self,
90
+ tree: ast.AST,
91
+ line_number: int
92
+ ) -> Optional[ast.Call]:
93
+ for node in ast.walk(tree):
94
+ if not isinstance(node, ast.Call):
95
+ continue
96
+ func = node.func
97
+ if not isinstance(func, ast.Attribute) or func.attr not in WEAK_HASH_ATTRS:
98
+ continue
99
+ if not (isinstance(func.value, ast.Name) and func.value.id == "hashlib"):
100
+ continue
101
+ node_lineno = getattr(node, "lineno", 0)
102
+ node_end = getattr(node, "end_lineno", node_lineno)
103
+ if node_lineno <= line_number <= node_end or node_lineno == line_number:
104
+ return node
105
+ return None
106
+
107
+ def _find_digest_parent(self, tree: ast.AST, call_node: ast.Call) -> Optional[ast.Call]:
108
+ """Return a wrapping .hexdigest()/.digest() call whose value is the hash call."""
109
+ for node in ast.walk(tree):
110
+ if not isinstance(node, ast.Call):
111
+ continue
112
+ func = node.func
113
+ if (
114
+ isinstance(func, ast.Attribute)
115
+ and func.attr in ("hexdigest", "digest")
116
+ and func.value is call_node
117
+ ):
118
+ return node
119
+ return None
120
+
121
+ def _replace_node(self, tree: ast.AST, old_node: ast.Call, new_node: ast.AST) -> None:
122
+ for parent in ast.walk(tree):
123
+ for field, value in ast.iter_fields(parent):
124
+ if value is old_node:
125
+ setattr(parent, field, new_node)
126
+ return
127
+ if isinstance(value, list):
128
+ for i, item in enumerate(value):
129
+ if item is old_node:
130
+ value[i] = new_node
131
+ return
@@ -0,0 +1,77 @@
1
+ """
2
+ TimeCodeSecurity - Vector D CWE-95 Dynamic Code Execution Transformer.
3
+ Implements deterministic AST-guided remediation replacing eval() with ast.literal_eval().
4
+ """
5
+
6
+ from typing import Any, Dict, Optional, Tuple
7
+ import ast
8
+
9
+ from remediation.base import BaseRemediationTransformer
10
+ from remediation.contracts import RemediationRule, PatchStatus
11
+
12
+
13
+ class Cwe95EvalTransformer(BaseRemediationTransformer):
14
+ """
15
+ Deterministic AST transformer for CWE-95 (Dynamic Code Evaluation).
16
+ Replaces eval() calls with ast.literal_eval() for safe literal parsing.
17
+ """
18
+
19
+ @property
20
+ def rule(self) -> RemediationRule:
21
+ return RemediationRule.EVAL_LITERAL_REPLACE
22
+
23
+ def can_transform(
24
+ self,
25
+ tree: ast.AST,
26
+ finding: Dict[str, Any],
27
+ source_code: str
28
+ ) -> bool:
29
+ """Check if finding is eval() call."""
30
+ line_number = finding.get("line_number", 0)
31
+ call_node = self._find_eval_call(tree, line_number)
32
+ return call_node is not None
33
+
34
+ def transform(
35
+ self,
36
+ tree: ast.AST,
37
+ finding: Dict[str, Any],
38
+ source_code: str
39
+ ) -> Tuple[PatchStatus, Optional[str], Optional[str], Tuple[str, ...]]:
40
+ """Replace eval() with ast.literal_eval()."""
41
+ line_number = finding.get("line_number", 0)
42
+
43
+ call_node = self._find_eval_call(tree, line_number)
44
+ if not call_node:
45
+ return (PatchStatus.UNSUPPORTED_CWE, None, None, ("eval call not found",))
46
+
47
+ # Replace function name from eval to ast.literal_eval
48
+ # Create ast.literal_eval attribute access
49
+ call_node.func = ast.Attribute(
50
+ value=ast.Name(id="ast", ctx=ast.Load()),
51
+ attr="literal_eval",
52
+ ctx=ast.Load()
53
+ )
54
+
55
+ try:
56
+ patched_source = ast.unparse(tree)
57
+ snippet = self.patched_statement_snippet(tree, source_code, line_number) or ""
58
+
59
+ return (PatchStatus.SUCCESS, patched_source, snippet, ())
60
+ except Exception as e:
61
+ return (PatchStatus.FAILED_SYNTAX, None, None, (f"AST unparse failed: {e}",))
62
+
63
+ def _find_eval_call(
64
+ self,
65
+ tree: ast.AST,
66
+ line_number: int
67
+ ) -> Optional[ast.Call]:
68
+ """Locate eval() call at or near the given line."""
69
+ for node in ast.walk(tree):
70
+ if isinstance(node, ast.Call):
71
+ func = node.func
72
+ if isinstance(func, ast.Name) and func.id == "eval":
73
+ node_lineno = getattr(node, "lineno", 0)
74
+ node_end = getattr(node, "end_lineno", node_lineno)
75
+ if node_lineno <= line_number <= node_end or node_lineno == line_number:
76
+ return node
77
+ return None
@@ -0,0 +1,114 @@
1
+ """
2
+ TimeCodeSecurity - Vector D Remediation Rule Dispatcher.
3
+ Deterministically maps CWE identifiers and RemediationRules to corresponding
4
+ AST transformers.
5
+ """
6
+
7
+ from typing import Any, Dict, Optional, Union
8
+ from remediation.base import BaseRemediationTransformer
9
+ from remediation.contracts import RemediationRule, PatchStatus
10
+ from remediation.cwe89_sqli import Cwe89ParameterizeTransformer
11
+ from remediation.cwe78_cmdi import Cwe78CmdInjectionTransformer
12
+ from remediation.cwe22_path_traversal import Cwe22PathTraversalTransformer
13
+ from remediation.cwe614_cookie import Cwe614CookieSecureTransformer
14
+ from remediation.cwe1336_jinja import Cwe1336JinjaAutoescapeTransformer
15
+ from remediation.cwe327_weak_hash import Cwe327WeakHashTransformer
16
+ from remediation.cwe916_password_hash import Cwe916PasswordHashTransformer
17
+ from remediation.cwe502_yaml import Cwe502YamlSafeLoaderTransformer
18
+ from remediation.cwe798_credentials import Cwe798CredentialsTransformer
19
+ from remediation.cwe489_debug import Cwe489DebugFlagTransformer
20
+ from remediation.cwe295_ssl import Cwe295SslVerificationTransformer
21
+ from remediation.cwe377_tempfile import Cwe377TempfileTransformer
22
+ from remediation.cwe95_eval import Cwe95EvalTransformer
23
+ from remediation.cwe1188_binding import Cwe1188NetworkBindingTransformer
24
+
25
+
26
+ class RuleDispatcher:
27
+ """
28
+ Deterministic rule dispatcher.
29
+ Maps CWE identifiers and RemediationRules to corresponding AST transformers.
30
+ Returns None for unsupported CWEs or rules.
31
+ """
32
+
33
+ def __init__(self):
34
+ self._cwe89_transformer = Cwe89ParameterizeTransformer()
35
+ self._cwe78_transformer = Cwe78CmdInjectionTransformer()
36
+ self._cwe22_transformer = Cwe22PathTraversalTransformer()
37
+ self._cwe614_transformer = Cwe614CookieSecureTransformer()
38
+ self._cwe1336_transformer = Cwe1336JinjaAutoescapeTransformer()
39
+ self._cwe327_transformer = Cwe327WeakHashTransformer()
40
+ self._cwe916_transformer = Cwe916PasswordHashTransformer()
41
+ self._cwe502_transformer = Cwe502YamlSafeLoaderTransformer()
42
+ self._cwe798_transformer = Cwe798CredentialsTransformer()
43
+ self._cwe489_transformer = Cwe489DebugFlagTransformer()
44
+ self._cwe295_transformer = Cwe295SslVerificationTransformer()
45
+ self._cwe377_transformer = Cwe377TempfileTransformer()
46
+ self._cwe95_transformer = Cwe95EvalTransformer()
47
+ self._cwe1188_transformer = Cwe1188NetworkBindingTransformer()
48
+
49
+ self._rule_map: Dict[RemediationRule, BaseRemediationTransformer] = {
50
+ RemediationRule.SQLI_PARAMETERIZE: self._cwe89_transformer,
51
+ RemediationRule.CMD_INJECTION_SPLIT: self._cwe78_transformer,
52
+ RemediationRule.PATH_TRAVERSAL_RESOLVE: self._cwe22_transformer,
53
+ RemediationRule.COOKIE_SECURE_FLAGS: self._cwe614_transformer,
54
+ RemediationRule.TEMPLATE_AUTOESCAPE: self._cwe1336_transformer,
55
+ RemediationRule.WEAK_HASH_REPLACE: self._cwe327_transformer,
56
+ RemediationRule.PASSWORD_HASH_KDF: self._cwe916_transformer,
57
+ RemediationRule.YAML_SAFE_LOADER: self._cwe502_transformer,
58
+ RemediationRule.CREDENTIAL_ENVIRON_GET: self._cwe798_transformer,
59
+ RemediationRule.DEBUG_FLAG_DISABLE: self._cwe489_transformer,
60
+ RemediationRule.SSL_VERIFY_ENABLE: self._cwe295_transformer,
61
+ RemediationRule.TEMPFILE_SECURE: self._cwe377_transformer,
62
+ RemediationRule.EVAL_LITERAL_REPLACE: self._cwe95_transformer,
63
+ RemediationRule.NETWORK_BINDING_LOCALHOST: self._cwe1188_transformer,
64
+ }
65
+ self._cwe_map: Dict[str, BaseRemediationTransformer] = {
66
+ "CWE-89": self._cwe89_transformer,
67
+ "CWE-78": self._cwe78_transformer,
68
+ "CWE-22": self._cwe22_transformer,
69
+ "CWE-614": self._cwe614_transformer,
70
+ "CWE-1275": self._cwe614_transformer,
71
+ # Alias: CWE-668 (Exposure of Resource to Wrong Sphere) shares the
72
+ # cookie-flags root cause.
73
+ "CWE-668": self._cwe614_transformer,
74
+ "CWE-1336": self._cwe1336_transformer,
75
+ # Alias: CWE-116 (Improper Encoding/Escaping of Output) covers the
76
+ # Jinja2 autoescape remediation.
77
+ "CWE-116": self._cwe1336_transformer,
78
+ "CWE-327": self._cwe327_transformer,
79
+ # Alias: CWE-916 / CWE-759 (weak or unsalted password hashing) needs a
80
+ # slow KDF; the sha256 swap would not clear these findings.
81
+ "CWE-916": self._cwe916_transformer,
82
+ "CWE-759": self._cwe916_transformer,
83
+ "CWE-502": self._cwe502_transformer,
84
+ "CWE-798": self._cwe798_transformer,
85
+ "CWE-489": self._cwe489_transformer,
86
+ "CWE-295": self._cwe295_transformer,
87
+ "CWE-377": self._cwe377_transformer,
88
+ "CWE-95": self._cwe95_transformer,
89
+ "CWE-1188": self._cwe1188_transformer,
90
+ }
91
+
92
+ def get_transformer(
93
+ self,
94
+ cwe: Optional[str] = None,
95
+ rule: Optional[Union[RemediationRule, str]] = None
96
+ ) -> Optional[BaseRemediationTransformer]:
97
+ """
98
+ Retrieves the registered transformer for the given CWE or rule.
99
+ Returns None if unsupported.
100
+ """
101
+ if rule is not None:
102
+ try:
103
+ rule_enum = RemediationRule(rule) if isinstance(rule, str) else rule
104
+ if rule_enum in self._rule_map:
105
+ return self._rule_map[rule_enum]
106
+ except ValueError:
107
+ return None
108
+
109
+ if cwe is not None:
110
+ norm_cwe = str(cwe).strip().upper()
111
+ if norm_cwe in self._cwe_map:
112
+ return self._cwe_map[norm_cwe]
113
+
114
+ return None