tng 0.5.4 → 0.5.5

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 CHANGED
@@ -1,7 +1,7 @@
1
1
  ---
2
2
  SHA256:
3
- metadata.gz: 8adc64b4a410ddec1b69ada11a09e9cee648f88692873ae6551990753ba0f564
4
- data.tar.gz: aa5c284afe9a769733b3ab87d37c1c51f23bf07ee4b3ffdfac65f60fe39f3548
3
+ metadata.gz: 953c1aca5e3a4e0da2fe7d31de410b02cdf10853ab296779684f351296517ac1
4
+ data.tar.gz: a38a4a270b74d49e47755db0833d1940393d2a698bcd848f2a57e60dc4e3213f
5
5
  SHA512:
6
- metadata.gz: 01701577e5856bbe861677eb03d8b8e629046e48e2301a4b4202cd78049252d7478ce7032c6f80cb547b9e9e324893bb5ad24859a16ae0491857287e9c040838
7
- data.tar.gz: 6c8e17a8f0d9e6d6a2fa0c564b01d54eaa28c4e1d495f0fe359818477eed439632b42ea96d2bc7dfd32543fe9ada7759989c71950b538fdb76e2debc6f17860d
6
+ metadata.gz: 410291bfb5dd3ad926278e778eb9c3f0fcf965f627f6bf15cd56c2bfcafdb4411a26210087826cd90eb8cea9835ab95fe5c31743024be7a44860a9f420700dde
7
+ data.tar.gz: 12c561e2c41a4fb339371445c53c5bfb1dfc3547d061c62a3c25d716d951be737e15422ad063807ff13d5d2176a09883b7ab4c3439ef9e56ee90a5b6cb4bd82a
data/README.md CHANGED
@@ -135,6 +135,13 @@ bundle exec tng --file app/models/order.rb --method calculate_total --trace
135
135
 
136
136
  # Short form
137
137
  bundle exec tng -f order.rb -m calculate_total -t
138
+
139
+ # V2 trace schema (LLM-oriented rich events)
140
+ bundle exec tng --file app/models/order.rb --method calculate_total --trace-v2
141
+
142
+ # Compare V1 and V2 as raw JSON
143
+ bundle exec tng --file app/models/order.rb --method calculate_total --trace --json > trace_v1.json
144
+ bundle exec tng --file app/models/order.rb --method calculate_total --trace-v2 --json > trace_v2.json
138
145
  ```
139
146
 
140
147
  **Trace Features:**
@@ -144,6 +151,14 @@ bundle exec tng -f order.rb -m calculate_total -t
144
151
  - Method call chains
145
152
  - Mermaid diagram generation
146
153
 
154
+ **V2 (LLM-Oriented) Additional Signals:**
155
+ - Structured events (`ASSIGN`, `CALL`, `CASE`, `WHEN`, `OUTCOME`, `RETURN`, etc.)
156
+ - Path-linked flow (`path_condition`, `parent_event_id`, `implicit_return`)
157
+ - Structured call arguments (`args`, `positional_args`, `keyword_args`, `block_arg`)
158
+ - Side-effect classification (`effects`: db/network/filesystem, tier, evidence)
159
+ - Caller evidence (`match_path`, `match_evidence`, receiver/class hints)
160
+ - Confidence context (`confidence_meta`) for safer downstream reasoning
161
+
147
162
  #### Regression Check
148
163
 
149
164
  Compare a method against its committed (`HEAD`) version and surface blast radius:
@@ -318,6 +333,7 @@ Path 3: !discount_code.present? → calculate_tax → total
318
333
  | `--method` | `-m` | Method name to analyze |
319
334
  | `--audit` | `-a` | Run audit mode |
320
335
  | `--trace` | `-t` | Run symbolic trace mode |
336
+ | `--trace-v2` | | Run symbolic trace mode (V2 schema) |
321
337
  | `--impact` | | Run regression check mode |
322
338
  | `--clones` | `-c` | Run clone detection |
323
339
  | `--deadcode` | `-d` | Run dead code detection |
@@ -337,6 +353,9 @@ bundle exec tng -f payment_service.rb -m process -a
337
353
  # Symbolic trace
338
354
  bundle exec tng -f order.rb -m calculate_total -t
339
355
 
356
+ # Symbolic trace V2
357
+ bundle exec tng -f order.rb -m calculate_total --trace-v2
358
+
340
359
  # Regression check
341
360
  bundle exec tng -f payment_service.rb -m process --impact
342
361