debugbundle 2.1.3 → 2.1.4
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.
- checksums.yaml +4 -4
- data/README.md +11 -1
- data/lib/debugbundle/before_send.rb +4 -2
- data/lib/debugbundle/evidence_graph.rb +2 -2
- data/lib/debugbundle/evidence_wire.rb +31 -3
- data/lib/debugbundle/version.rb +1 -1
- metadata +1 -1
checksums.yaml
CHANGED
|
@@ -1,7 +1,7 @@
|
|
|
1
1
|
---
|
|
2
2
|
SHA256:
|
|
3
|
-
metadata.gz:
|
|
4
|
-
data.tar.gz:
|
|
3
|
+
metadata.gz: 595fd6366269058ad31b1116571a35fad4e586064b7f5032babb5fe85de57d95
|
|
4
|
+
data.tar.gz: 5248c51d1105c90d82df8db686895eff22183e0a7ec726640e13fec18def055a
|
|
5
5
|
SHA512:
|
|
6
|
-
metadata.gz:
|
|
7
|
-
data.tar.gz:
|
|
6
|
+
metadata.gz: ca026bbe971a599ebfcabbd12d5793d5e8dc6a6efbc22bac27fe6fc99f393ae967d0b0849801494b90208a4305c2bf7b0e6c76162b05c2c36d8a1fe2d3408794
|
|
7
|
+
data.tar.gz: 56a2441e09a08dd86f4f1ffb6c4720214e7a705edbe676a45d289acf5b28ade393c42580f77b563e006b03c704821b9021fbdb0361cc22374e8e6c27bf9424df
|
data/README.md
CHANGED
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
# debugbundle
|
|
2
2
|
|
|
3
|
-
Patch 2.1.
|
|
3
|
+
Patch 2.1.4 preserves application hook redaction under optional-evidence limits and complete validation. Public capture APIs and event schemas remain compatible.
|
|
4
4
|
|
|
5
5
|
Ruby SDK for DebugBundle.
|
|
6
6
|
|
|
@@ -543,3 +543,13 @@ evidence disabled and enabled, including a full warning queue. It reports captur
|
|
|
543
543
|
time, allocated Ruby objects and retained bytes, and verifies original-error
|
|
544
544
|
priority and the existing queue/diagnostic ceilings. Setup and cleanup are excluded;
|
|
545
545
|
the existing `sdk-safety-perf` timing limits remain unchanged.
|
|
546
|
+
|
|
547
|
+
### Hook size limits (unreleased correction)
|
|
548
|
+
|
|
549
|
+
A hook replacement whose optional exception evidence exceeds the combined 32 KiB
|
|
550
|
+
UTF-8 JSON budget keeps its replacement message and other primary fields. The SDK
|
|
551
|
+
omits the oversized optional evidence and its typed reference, recording
|
|
552
|
+
`context.evidence_limits`. Ordinary custom context remains intact. A size limit
|
|
553
|
+
must not restore text removed by the hook; an otherwise valid replacement that
|
|
554
|
+
cannot fit later ownership or transport limits is withheld. Malformed returns and
|
|
555
|
+
throwing hooks retain the established protected-original fallback.
|
|
@@ -51,7 +51,7 @@ module DebugBundle
|
|
|
51
51
|
result = hook.call(Marshal.load(Marshal.dump(event)))
|
|
52
52
|
return nil if result.nil?
|
|
53
53
|
|
|
54
|
-
checked = normalization_result(result)
|
|
54
|
+
checked = normalization_result(result, reduce_evidence: true)
|
|
55
55
|
return nil if checked.equal?(EvidenceValue::EXHAUSTED)
|
|
56
56
|
|
|
57
57
|
checked || event
|
|
@@ -68,7 +68,7 @@ module DebugBundle
|
|
|
68
68
|
EvidenceValue.type?(result, Hash) ? result : nil
|
|
69
69
|
end
|
|
70
70
|
|
|
71
|
-
def normalization_result(event)
|
|
71
|
+
def normalization_result(event, reduce_evidence: false)
|
|
72
72
|
return nil unless EvidenceValue.type?(event, Hash)
|
|
73
73
|
return nil if Hash.instance_method(:size).bind_call(event) > ROOT_FIELDS.length
|
|
74
74
|
|
|
@@ -78,6 +78,8 @@ module DebugBundle
|
|
|
78
78
|
max_string_bytes: 8 * 1024 * 1024)
|
|
79
79
|
return owned if owned.equal?(EvidenceValue::EXHAUSTED)
|
|
80
80
|
return nil unless EvidenceValue.type?(owned, Hash)
|
|
81
|
+
|
|
82
|
+
owned = EvidenceWire.fit_hook_evidence(owned) if reduce_evidence
|
|
81
83
|
return nil unless CanonicalEventSchema.valid?(owned) && EvidenceWire.valid_optional?(owned)
|
|
82
84
|
return nil unless required_frontend_context?(owned)
|
|
83
85
|
|
|
@@ -4,7 +4,7 @@ module DebugBundle
|
|
|
4
4
|
module EvidenceGraph
|
|
5
5
|
module_function
|
|
6
6
|
|
|
7
|
-
def valid?(value)
|
|
7
|
+
def valid?(value, check_byte_budget: true)
|
|
8
8
|
wire = EvidenceWire
|
|
9
9
|
return false unless wire.closed(value, %w[version runtime root_id nodes truncated unavailable_reason])
|
|
10
10
|
return false unless wire.integer(value['version'], 1, 1) && wire.integer(value['root_id'], 0, 7)
|
|
@@ -25,7 +25,7 @@ module DebugBundle
|
|
|
25
25
|
end
|
|
26
26
|
visited = {}
|
|
27
27
|
visit(value['root_id'], adjacency, [], visited) && visited.length == nodes.length &&
|
|
28
|
-
EvidenceJson.bytes(value) <= 32_768
|
|
28
|
+
(!check_byte_budget || EvidenceJson.bytes(value) <= 32_768)
|
|
29
29
|
end
|
|
30
30
|
|
|
31
31
|
def valid_node?(node)
|
|
@@ -111,7 +111,7 @@ module DebugBundle
|
|
|
111
111
|
(value['limit_ms'].nil? || number(value['limit_ms']))
|
|
112
112
|
end
|
|
113
113
|
|
|
114
|
-
def valid_optional?(event)
|
|
114
|
+
def valid_optional?(event, check_byte_budget: true)
|
|
115
115
|
return false unless EvidenceValue.type?(event, Hash)
|
|
116
116
|
|
|
117
117
|
payload = Hash.instance_method(:fetch).bind_call(event, 'payload', nil)
|
|
@@ -127,7 +127,12 @@ module DebugBundle
|
|
|
127
127
|
return false unless allowed_field?(type, field)
|
|
128
128
|
|
|
129
129
|
owned = EvidenceValue.copy(Hash.instance_method(:fetch).bind_call(payload, field))
|
|
130
|
-
|
|
130
|
+
valid = if field == 'exception_evidence'
|
|
131
|
+
EvidenceGraph.valid?(owned, check_byte_budget: check_byte_budget)
|
|
132
|
+
else
|
|
133
|
+
field == 'execution' ? execution(owned) : validator.valid?(owned)
|
|
134
|
+
end
|
|
135
|
+
return false unless valid
|
|
131
136
|
|
|
132
137
|
additions[field] = owned
|
|
133
138
|
end
|
|
@@ -141,7 +146,7 @@ module DebugBundle
|
|
|
141
146
|
nil))
|
|
142
147
|
end
|
|
143
148
|
additions['evidence_reference'] = selected if selected
|
|
144
|
-
EvidenceJson.bytes(additions) <= 32_768
|
|
149
|
+
!check_byte_budget || EvidenceJson.bytes(additions) <= 32_768
|
|
145
150
|
rescue StandardError
|
|
146
151
|
false
|
|
147
152
|
end
|
|
@@ -180,6 +185,29 @@ module DebugBundle
|
|
|
180
185
|
result
|
|
181
186
|
end
|
|
182
187
|
|
|
188
|
+
# Owned JSON only: optional byte exhaustion cannot restore pre-hook content.
|
|
189
|
+
def fit_hook_evidence(event)
|
|
190
|
+
return event unless %w[backend_exception frontend_exception].include?(event['event_type'])
|
|
191
|
+
|
|
192
|
+
payload = event['payload']
|
|
193
|
+
return event unless payload.is_a?(Hash)
|
|
194
|
+
|
|
195
|
+
additions = payload.slice('exception_evidence', 'execution', 'resource_observations')
|
|
196
|
+
return event if additions.empty?
|
|
197
|
+
return event if event.key?('context') && !event['context'].is_a?(Hash)
|
|
198
|
+
|
|
199
|
+
context = event['context'].is_a?(Hash) ? event['context'].dup : {}
|
|
200
|
+
selected = reference(context['evidence_reference'])
|
|
201
|
+
additions['evidence_reference'] = context['evidence_reference'] if selected
|
|
202
|
+
return event if EvidenceJson.bytes(additions) <= 32_768
|
|
203
|
+
return event unless valid_optional?(event, check_byte_budget: false)
|
|
204
|
+
|
|
205
|
+
context.delete('evidence_reference') if selected
|
|
206
|
+
additions.delete('evidence_reference')
|
|
207
|
+
context['evidence_limits'] = { 'version' => 1 }.merge(additions.transform_values { 'budget_exceeded' })
|
|
208
|
+
without_optional(event).merge('context' => context)
|
|
209
|
+
end
|
|
210
|
+
|
|
183
211
|
def without_optional(event)
|
|
184
212
|
return nil unless event.is_a?(Hash) && %w[backend_exception frontend_exception].include?(event['event_type'])
|
|
185
213
|
|
data/lib/debugbundle/version.rb
CHANGED