sdr-visualizer 1.2.6__tar.gz → 1.2.9__tar.gz

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 (184) hide show
  1. {sdr_visualizer-1.2.6 → sdr_visualizer-1.2.9}/AGENTS.md +2 -1
  2. {sdr_visualizer-1.2.6 → sdr_visualizer-1.2.9}/CHANGELOG.md +127 -1
  3. {sdr_visualizer-1.2.6 → sdr_visualizer-1.2.9}/PKG-INFO +37 -16
  4. {sdr_visualizer-1.2.6 → sdr_visualizer-1.2.9}/README.md +25 -14
  5. {sdr_visualizer-1.2.6 → sdr_visualizer-1.2.9}/docs/ADAPTER_GUIDE.md +55 -3
  6. {sdr_visualizer-1.2.6 → sdr_visualizer-1.2.9}/docs/LINEAGE.md +7 -10
  7. {sdr_visualizer-1.2.6 → sdr_visualizer-1.2.9}/docs/PERFORMANCE.md +4 -1
  8. {sdr_visualizer-1.2.6 → sdr_visualizer-1.2.9}/docs/PRODUCT_CONTRACT.md +13 -4
  9. {sdr_visualizer-1.2.6 → sdr_visualizer-1.2.9}/docs/RELEASING.md +11 -3
  10. {sdr_visualizer-1.2.6 → sdr_visualizer-1.2.9}/docs/WORKSPACE_USAGE.md +1 -1
  11. {sdr_visualizer-1.2.6 → sdr_visualizer-1.2.9}/pyproject.toml +17 -2
  12. {sdr_visualizer-1.2.6 → sdr_visualizer-1.2.9}/scripts/check_workflow_policy.py +18 -1
  13. {sdr_visualizer-1.2.6 → sdr_visualizer-1.2.9}/scripts/dependabot_review.py +44 -9
  14. {sdr_visualizer-1.2.6 → sdr_visualizer-1.2.9}/scripts/perf_browser_check.py +10 -0
  15. {sdr_visualizer-1.2.6 → sdr_visualizer-1.2.9}/src/sdr_visualizer/__init__.py +1 -1
  16. {sdr_visualizer-1.2.6 → sdr_visualizer-1.2.9}/src/sdr_visualizer/adapters/aa.py +75 -28
  17. {sdr_visualizer-1.2.6 → sdr_visualizer-1.2.9}/src/sdr_visualizer/adapters/cja.py +87 -35
  18. {sdr_visualizer-1.2.6 → sdr_visualizer-1.2.9}/src/sdr_visualizer/cli/lineage.py +6 -2
  19. {sdr_visualizer-1.2.6 → sdr_visualizer-1.2.9}/src/sdr_visualizer/cli/lineage_output.py +7 -0
  20. {sdr_visualizer-1.2.6 → sdr_visualizer-1.2.9}/src/sdr_visualizer/cli/main.py +5 -5
  21. sdr_visualizer-1.2.9/src/sdr_visualizer/cli/output_safety.py +61 -0
  22. {sdr_visualizer-1.2.6 → sdr_visualizer-1.2.9}/src/sdr_visualizer/cli/workspace_usage.py +2 -4
  23. {sdr_visualizer-1.2.6 → sdr_visualizer-1.2.9}/src/sdr_visualizer/core/structure_limits.py +3 -1
  24. {sdr_visualizer-1.2.6 → sdr_visualizer-1.2.9}/src/sdr_visualizer/core/workspace_usage.py +2 -1
  25. {sdr_visualizer-1.2.6 → sdr_visualizer-1.2.9}/src/sdr_visualizer/input/detect.py +2 -1
  26. sdr_visualizer-1.2.9/src/sdr_visualizer/input/json_io.py +19 -0
  27. {sdr_visualizer-1.2.6 → sdr_visualizer-1.2.9}/src/sdr_visualizer/input/lineage_discovery.py +36 -5
  28. {sdr_visualizer-1.2.6 → sdr_visualizer-1.2.9}/src/sdr_visualizer/input/loader.py +45 -10
  29. {sdr_visualizer-1.2.6 → sdr_visualizer-1.2.9}/src/sdr_visualizer/input/series.py +2 -2
  30. {sdr_visualizer-1.2.6 → sdr_visualizer-1.2.9}/src/sdr_visualizer/input/shell_out.py +20 -4
  31. {sdr_visualizer-1.2.6 → sdr_visualizer-1.2.9}/src/sdr_visualizer/usage/normalize.py +1 -1
  32. {sdr_visualizer-1.2.6 → sdr_visualizer-1.2.9}/tests/test_adapters_aa.py +1 -1
  33. {sdr_visualizer-1.2.6 → sdr_visualizer-1.2.9}/tests/test_adapters_cja.py +44 -4
  34. {sdr_visualizer-1.2.6 → sdr_visualizer-1.2.9}/tests/test_browser_functional.py +22 -12
  35. {sdr_visualizer-1.2.6 → sdr_visualizer-1.2.9}/tests/test_cli.py +4 -4
  36. {sdr_visualizer-1.2.6 → sdr_visualizer-1.2.9}/tests/test_dependabot_review.py +127 -4
  37. sdr_visualizer-1.2.9/tests/test_input_hardening.py +407 -0
  38. {sdr_visualizer-1.2.6 → sdr_visualizer-1.2.9}/tests/test_input_modes.py +74 -5
  39. {sdr_visualizer-1.2.6 → sdr_visualizer-1.2.9}/tests/test_input_series.py +13 -0
  40. {sdr_visualizer-1.2.6 → sdr_visualizer-1.2.9}/tests/test_lineage_cli.py +41 -2
  41. {sdr_visualizer-1.2.6 → sdr_visualizer-1.2.9}/tests/test_lineage_discovery.py +66 -12
  42. {sdr_visualizer-1.2.6 → sdr_visualizer-1.2.9}/tests/test_output_safety.py +133 -2
  43. {sdr_visualizer-1.2.6 → sdr_visualizer-1.2.9}/tests/test_structure_limits.py +20 -0
  44. {sdr_visualizer-1.2.6 → sdr_visualizer-1.2.9}/tests/test_workflow_policy.py +42 -0
  45. {sdr_visualizer-1.2.6 → sdr_visualizer-1.2.9}/tests/test_workspace_usage_aa_sdk.py +1 -1
  46. {sdr_visualizer-1.2.6 → sdr_visualizer-1.2.9}/tests/test_workspace_usage_cli.py +54 -5
  47. {sdr_visualizer-1.2.6 → sdr_visualizer-1.2.9}/tests/test_workspace_usage_collection.py +6 -0
  48. sdr_visualizer-1.2.6/docs/ADAPTER_CORRECTNESS_1.1.2.md +0 -114
  49. sdr_visualizer-1.2.6/docs/DEPENDABOT_AUTOMATION.md +0 -116
  50. sdr_visualizer-1.2.6/docs/RELEASE_EVIDENCE_TEMPLATE.md +0 -385
  51. sdr_visualizer-1.2.6/src/sdr_visualizer/cli/output_safety.py +0 -28
  52. {sdr_visualizer-1.2.6 → sdr_visualizer-1.2.9}/.gitignore +0 -0
  53. {sdr_visualizer-1.2.6 → sdr_visualizer-1.2.9}/CODE_OF_CONDUCT.md +0 -0
  54. {sdr_visualizer-1.2.6 → sdr_visualizer-1.2.9}/CONTRIBUTING.md +0 -0
  55. {sdr_visualizer-1.2.6 → sdr_visualizer-1.2.9}/LICENSE +0 -0
  56. {sdr_visualizer-1.2.6 → sdr_visualizer-1.2.9}/SECURITY.md +0 -0
  57. {sdr_visualizer-1.2.6 → sdr_visualizer-1.2.9}/THIRD_PARTY_LICENSES +0 -0
  58. {sdr_visualizer-1.2.6 → sdr_visualizer-1.2.9}/docs/ARCHITECTURE.md +0 -0
  59. {sdr_visualizer-1.2.6 → sdr_visualizer-1.2.9}/docs/EMBEDDED_DATA_FORMAT.md +0 -0
  60. {sdr_visualizer-1.2.6 → sdr_visualizer-1.2.9}/docs/SHOWCASE.md +0 -0
  61. {sdr_visualizer-1.2.6 → sdr_visualizer-1.2.9}/docs/payload-schema.json +0 -0
  62. {sdr_visualizer-1.2.6 → sdr_visualizer-1.2.9}/docs/workspace-usage-schema.json +0 -0
  63. {sdr_visualizer-1.2.6 → sdr_visualizer-1.2.9}/scripts/capture_screenshot.py +0 -0
  64. {sdr_visualizer-1.2.6 → sdr_visualizer-1.2.9}/scripts/check_color_pack_parity.py +0 -0
  65. {sdr_visualizer-1.2.6 → sdr_visualizer-1.2.9}/scripts/check_markdown_links.py +0 -0
  66. {sdr_visualizer-1.2.6 → sdr_visualizer-1.2.9}/scripts/corpus_check.py +0 -0
  67. {sdr_visualizer-1.2.6 → sdr_visualizer-1.2.9}/scripts/generate_aa_large_fixture.py +0 -0
  68. {sdr_visualizer-1.2.6 → sdr_visualizer-1.2.9}/scripts/generate_cja_lineage_poc.py +0 -0
  69. {sdr_visualizer-1.2.6 → sdr_visualizer-1.2.9}/scripts/generate_examples.py +0 -0
  70. {sdr_visualizer-1.2.6 → sdr_visualizer-1.2.9}/scripts/generate_large_fixture.py +0 -0
  71. {sdr_visualizer-1.2.6 → sdr_visualizer-1.2.9}/scripts/mutate_fixture.py +0 -0
  72. {sdr_visualizer-1.2.6 → sdr_visualizer-1.2.9}/scripts/package_smoke_check.py +0 -0
  73. {sdr_visualizer-1.2.6 → sdr_visualizer-1.2.9}/scripts/perf_check.py +0 -0
  74. {sdr_visualizer-1.2.6 → sdr_visualizer-1.2.9}/scripts/perf_lineage_poc.py +0 -0
  75. {sdr_visualizer-1.2.6 → sdr_visualizer-1.2.9}/scripts/workspace_usage_fixture.py +0 -0
  76. {sdr_visualizer-1.2.6 → sdr_visualizer-1.2.9}/src/sdr_visualizer/__main__.py +0 -0
  77. {sdr_visualizer-1.2.6 → sdr_visualizer-1.2.9}/src/sdr_visualizer/adapters/__init__.py +0 -0
  78. {sdr_visualizer-1.2.6 → sdr_visualizer-1.2.9}/src/sdr_visualizer/adapters/base.py +0 -0
  79. {sdr_visualizer-1.2.6 → sdr_visualizer-1.2.9}/src/sdr_visualizer/adapters/cja_lineage.py +0 -0
  80. {sdr_visualizer-1.2.6 → sdr_visualizer-1.2.9}/src/sdr_visualizer/analysis/__init__.py +0 -0
  81. {sdr_visualizer-1.2.6 → sdr_visualizer-1.2.9}/src/sdr_visualizer/analysis/diff.py +0 -0
  82. {sdr_visualizer-1.2.6 → sdr_visualizer-1.2.9}/src/sdr_visualizer/analysis/formula_tree.py +0 -0
  83. {sdr_visualizer-1.2.6 → sdr_visualizer-1.2.9}/src/sdr_visualizer/analysis/lineage_layout.py +0 -0
  84. {sdr_visualizer-1.2.6 → sdr_visualizer-1.2.9}/src/sdr_visualizer/analysis/references.py +0 -0
  85. {sdr_visualizer-1.2.6 → sdr_visualizer-1.2.9}/src/sdr_visualizer/analysis/segment_tree.py +0 -0
  86. {sdr_visualizer-1.2.6 → sdr_visualizer-1.2.9}/src/sdr_visualizer/analysis/trend.py +0 -0
  87. {sdr_visualizer-1.2.6 → sdr_visualizer-1.2.9}/src/sdr_visualizer/cli/__init__.py +0 -0
  88. {sdr_visualizer-1.2.6 → sdr_visualizer-1.2.9}/src/sdr_visualizer/cli/exit_codes.py +0 -0
  89. {sdr_visualizer-1.2.6 → sdr_visualizer-1.2.9}/src/sdr_visualizer/core/__init__.py +0 -0
  90. {sdr_visualizer-1.2.6 → sdr_visualizer-1.2.9}/src/sdr_visualizer/core/exceptions.py +0 -0
  91. {sdr_visualizer-1.2.6 → sdr_visualizer-1.2.9}/src/sdr_visualizer/core/lineage.py +0 -0
  92. {sdr_visualizer-1.2.6 → sdr_visualizer-1.2.9}/src/sdr_visualizer/core/models.py +0 -0
  93. {sdr_visualizer-1.2.6 → sdr_visualizer-1.2.9}/src/sdr_visualizer/core/visualizer.py +0 -0
  94. {sdr_visualizer-1.2.6 → sdr_visualizer-1.2.9}/src/sdr_visualizer/input/__init__.py +0 -0
  95. {sdr_visualizer-1.2.6 → sdr_visualizer-1.2.9}/src/sdr_visualizer/input/workspace_usage.py +0 -0
  96. {sdr_visualizer-1.2.6 → sdr_visualizer-1.2.9}/src/sdr_visualizer/render/__init__.py +0 -0
  97. {sdr_visualizer-1.2.6 → sdr_visualizer-1.2.9}/src/sdr_visualizer/render/color_packs.py +0 -0
  98. {sdr_visualizer-1.2.6 → sdr_visualizer-1.2.9}/src/sdr_visualizer/render/data_payload.py +0 -0
  99. {sdr_visualizer-1.2.6 → sdr_visualizer-1.2.9}/src/sdr_visualizer/render/lineage_payload.py +0 -0
  100. {sdr_visualizer-1.2.6 → sdr_visualizer-1.2.9}/src/sdr_visualizer/render/lineage_renderer.py +0 -0
  101. {sdr_visualizer-1.2.6 → sdr_visualizer-1.2.9}/src/sdr_visualizer/render/renderer.py +0 -0
  102. {sdr_visualizer-1.2.6 → sdr_visualizer-1.2.9}/src/sdr_visualizer/render/static/cja_lineage.css +0 -0
  103. {sdr_visualizer-1.2.6 → sdr_visualizer-1.2.9}/src/sdr_visualizer/render/static/cja_lineage.js +0 -0
  104. {sdr_visualizer-1.2.6 → sdr_visualizer-1.2.9}/src/sdr_visualizer/render/static/cja_lineage_graph.js +0 -0
  105. {sdr_visualizer-1.2.6 → sdr_visualizer-1.2.9}/src/sdr_visualizer/render/static/cja_lineage_roles.js +0 -0
  106. {sdr_visualizer-1.2.6 → sdr_visualizer-1.2.9}/src/sdr_visualizer/render/static/d3.min.js +0 -0
  107. {sdr_visualizer-1.2.6 → sdr_visualizer-1.2.9}/src/sdr_visualizer/render/static/visualizer.css +0 -0
  108. {sdr_visualizer-1.2.6 → sdr_visualizer-1.2.9}/src/sdr_visualizer/render/static/visualizer.js +0 -0
  109. {sdr_visualizer-1.2.6 → sdr_visualizer-1.2.9}/src/sdr_visualizer/render/static/visualizer_trend.js +0 -0
  110. {sdr_visualizer-1.2.6 → sdr_visualizer-1.2.9}/src/sdr_visualizer/render/templates/catalog.html.j2 +0 -0
  111. {sdr_visualizer-1.2.6 → sdr_visualizer-1.2.9}/src/sdr_visualizer/render/templates/changes.html.j2 +0 -0
  112. {sdr_visualizer-1.2.6 → sdr_visualizer-1.2.9}/src/sdr_visualizer/render/templates/cja_lineage.html.j2 +0 -0
  113. {sdr_visualizer-1.2.6 → sdr_visualizer-1.2.9}/src/sdr_visualizer/render/templates/graph.html.j2 +0 -0
  114. {sdr_visualizer-1.2.6 → sdr_visualizer-1.2.9}/src/sdr_visualizer/render/templates/index.html.j2 +0 -0
  115. {sdr_visualizer-1.2.6 → sdr_visualizer-1.2.9}/src/sdr_visualizer/render/templates/trend.html.j2 +0 -0
  116. {sdr_visualizer-1.2.6 → sdr_visualizer-1.2.9}/src/sdr_visualizer/render/trend_charts.py +0 -0
  117. {sdr_visualizer-1.2.6 → sdr_visualizer-1.2.9}/src/sdr_visualizer/render/workspace_usage.py +0 -0
  118. {sdr_visualizer-1.2.6 → sdr_visualizer-1.2.9}/src/sdr_visualizer/usage/__init__.py +0 -0
  119. {sdr_visualizer-1.2.6 → sdr_visualizer-1.2.9}/src/sdr_visualizer/usage/aa_api.py +0 -0
  120. {sdr_visualizer-1.2.6 → sdr_visualizer-1.2.9}/src/sdr_visualizer/usage/aa_sdk.py +0 -0
  121. {sdr_visualizer-1.2.6 → sdr_visualizer-1.2.9}/src/sdr_visualizer/usage/auth.py +0 -0
  122. {sdr_visualizer-1.2.6 → sdr_visualizer-1.2.9}/src/sdr_visualizer/usage/cja_api.py +0 -0
  123. {sdr_visualizer-1.2.6 → sdr_visualizer-1.2.9}/src/sdr_visualizer/usage/cja_sdk.py +0 -0
  124. {sdr_visualizer-1.2.6 → sdr_visualizer-1.2.9}/src/sdr_visualizer/usage/collector.py +0 -0
  125. {sdr_visualizer-1.2.6 → sdr_visualizer-1.2.9}/src/sdr_visualizer/usage/sdk_worker.py +0 -0
  126. {sdr_visualizer-1.2.6 → sdr_visualizer-1.2.9}/src/sdr_visualizer/usage/transport.py +0 -0
  127. {sdr_visualizer-1.2.6 → sdr_visualizer-1.2.9}/tests/__init__.py +0 -0
  128. {sdr_visualizer-1.2.6 → sdr_visualizer-1.2.9}/tests/adapter_cases.py +0 -0
  129. {sdr_visualizer-1.2.6 → sdr_visualizer-1.2.9}/tests/browser_support.py +0 -0
  130. {sdr_visualizer-1.2.6 → sdr_visualizer-1.2.9}/tests/conftest.py +0 -0
  131. {sdr_visualizer-1.2.6 → sdr_visualizer-1.2.9}/tests/fixtures/__init__.py +0 -0
  132. {sdr_visualizer-1.2.6 → sdr_visualizer-1.2.9}/tests/fixtures/aa_snapshot_clean.json +0 -0
  133. {sdr_visualizer-1.2.6 → sdr_visualizer-1.2.9}/tests/fixtures/aa_snapshot_messy.json +0 -0
  134. {sdr_visualizer-1.2.6 → sdr_visualizer-1.2.9}/tests/fixtures/cja_lineage_degraded.json +0 -0
  135. {sdr_visualizer-1.2.6 → sdr_visualizer-1.2.9}/tests/fixtures/cja_lineage_enriched.json +0 -0
  136. {sdr_visualizer-1.2.6 → sdr_visualizer-1.2.9}/tests/fixtures/cja_lineage_hostile.json +0 -0
  137. {sdr_visualizer-1.2.6 → sdr_visualizer-1.2.9}/tests/fixtures/cja_lineage_shared.json +0 -0
  138. {sdr_visualizer-1.2.6 → sdr_visualizer-1.2.9}/tests/fixtures/cja_snapshot_clean.json +0 -0
  139. {sdr_visualizer-1.2.6 → sdr_visualizer-1.2.9}/tests/fixtures/cja_snapshot_hostile.json +0 -0
  140. {sdr_visualizer-1.2.6 → sdr_visualizer-1.2.9}/tests/fixtures/cja_snapshot_messy.json +0 -0
  141. {sdr_visualizer-1.2.6 → sdr_visualizer-1.2.9}/tests/fixtures/cja_snapshot_minimal.json +0 -0
  142. {sdr_visualizer-1.2.6 → sdr_visualizer-1.2.9}/tests/fixtures/workspace_usage_aa_all_types.json +0 -0
  143. {sdr_visualizer-1.2.6 → sdr_visualizer-1.2.9}/tests/fixtures/workspace_usage_cja_all_types.json +0 -0
  144. {sdr_visualizer-1.2.6 → sdr_visualizer-1.2.9}/tests/test_adapter_correctness.py +0 -0
  145. {sdr_visualizer-1.2.6 → sdr_visualizer-1.2.9}/tests/test_adapter_fuzz.py +0 -0
  146. {sdr_visualizer-1.2.6 → sdr_visualizer-1.2.9}/tests/test_analysis_diff.py +0 -0
  147. {sdr_visualizer-1.2.6 → sdr_visualizer-1.2.9}/tests/test_analysis_formula_tree.py +0 -0
  148. {sdr_visualizer-1.2.6 → sdr_visualizer-1.2.9}/tests/test_analysis_references.py +0 -0
  149. {sdr_visualizer-1.2.6 → sdr_visualizer-1.2.9}/tests/test_analysis_segment_tree.py +0 -0
  150. {sdr_visualizer-1.2.6 → sdr_visualizer-1.2.9}/tests/test_analysis_trend.py +0 -0
  151. {sdr_visualizer-1.2.6 → sdr_visualizer-1.2.9}/tests/test_browser_support.py +0 -0
  152. {sdr_visualizer-1.2.6 → sdr_visualizer-1.2.9}/tests/test_cja_lineage.py +0 -0
  153. {sdr_visualizer-1.2.6 → sdr_visualizer-1.2.9}/tests/test_cja_lineage_driver.py +0 -0
  154. {sdr_visualizer-1.2.6 → sdr_visualizer-1.2.9}/tests/test_cli_flags.py +0 -0
  155. {sdr_visualizer-1.2.6 → sdr_visualizer-1.2.9}/tests/test_color_pack_parity.py +0 -0
  156. {sdr_visualizer-1.2.6 → sdr_visualizer-1.2.9}/tests/test_color_packs.py +0 -0
  157. {sdr_visualizer-1.2.6 → sdr_visualizer-1.2.9}/tests/test_corpus_check.py +0 -0
  158. {sdr_visualizer-1.2.6 → sdr_visualizer-1.2.9}/tests/test_data_payload.py +0 -0
  159. {sdr_visualizer-1.2.6 → sdr_visualizer-1.2.9}/tests/test_entrypoint.py +0 -0
  160. {sdr_visualizer-1.2.6 → sdr_visualizer-1.2.9}/tests/test_generate_examples.py +0 -0
  161. {sdr_visualizer-1.2.6 → sdr_visualizer-1.2.9}/tests/test_lineage_browser.py +0 -0
  162. {sdr_visualizer-1.2.6 → sdr_visualizer-1.2.9}/tests/test_lineage_performance.py +0 -0
  163. {sdr_visualizer-1.2.6 → sdr_visualizer-1.2.9}/tests/test_lineage_renderer.py +0 -0
  164. {sdr_visualizer-1.2.6 → sdr_visualizer-1.2.9}/tests/test_markdown_links.py +0 -0
  165. {sdr_visualizer-1.2.6 → sdr_visualizer-1.2.9}/tests/test_minimal_fixture.py +0 -0
  166. {sdr_visualizer-1.2.6 → sdr_visualizer-1.2.9}/tests/test_mutate_fixture.py +0 -0
  167. {sdr_visualizer-1.2.6 → sdr_visualizer-1.2.9}/tests/test_package_smoke_check.py +0 -0
  168. {sdr_visualizer-1.2.6 → sdr_visualizer-1.2.9}/tests/test_payload_schema.py +0 -0
  169. {sdr_visualizer-1.2.6 → sdr_visualizer-1.2.9}/tests/test_perf.py +0 -0
  170. {sdr_visualizer-1.2.6 → sdr_visualizer-1.2.9}/tests/test_perf_browser_check.py +0 -0
  171. {sdr_visualizer-1.2.6 → sdr_visualizer-1.2.9}/tests/test_release_documentation.py +0 -0
  172. {sdr_visualizer-1.2.6 → sdr_visualizer-1.2.9}/tests/test_renderer.py +0 -0
  173. {sdr_visualizer-1.2.6 → sdr_visualizer-1.2.9}/tests/test_renderer_anatomy.py +0 -0
  174. {sdr_visualizer-1.2.6 → sdr_visualizer-1.2.9}/tests/test_renderer_graph.py +0 -0
  175. {sdr_visualizer-1.2.6 → sdr_visualizer-1.2.9}/tests/test_semantic_properties.py +0 -0
  176. {sdr_visualizer-1.2.6 → sdr_visualizer-1.2.9}/tests/test_trend_charts.py +0 -0
  177. {sdr_visualizer-1.2.6 → sdr_visualizer-1.2.9}/tests/test_workspace_usage.py +0 -0
  178. {sdr_visualizer-1.2.6 → sdr_visualizer-1.2.9}/tests/test_workspace_usage_auth.py +0 -0
  179. {sdr_visualizer-1.2.6 → sdr_visualizer-1.2.9}/tests/test_workspace_usage_cja_sdk.py +0 -0
  180. {sdr_visualizer-1.2.6 → sdr_visualizer-1.2.9}/tests/test_workspace_usage_offline.py +0 -0
  181. {sdr_visualizer-1.2.6 → sdr_visualizer-1.2.9}/tests/test_workspace_usage_payload.py +0 -0
  182. {sdr_visualizer-1.2.6 → sdr_visualizer-1.2.9}/tests/test_workspace_usage_perf.py +0 -0
  183. {sdr_visualizer-1.2.6 → sdr_visualizer-1.2.9}/tests/test_workspace_usage_sdk.py +0 -0
  184. {sdr_visualizer-1.2.6 → sdr_visualizer-1.2.9}/tests/test_workspace_usage_transport.py +0 -0
@@ -47,7 +47,8 @@ only requires Jinja2. The `dev` group supplies Python test/lint tooling and
47
47
  `browser` supplies Playwright. On Linux, use
48
48
  `uv run playwright install --with-deps chromium webkit` if browser system libraries
49
49
  are missing. `tests/conftest.py` generates missing large CJA/AA fixtures on demand.
50
- Do not commit generated performance fixtures or caches.
50
+ Do not commit generated performance fixtures or caches. Add `-n auto` to any
51
+ pytest command below to run it in parallel with `pytest-xdist`, as CI does.
51
52
 
52
53
  Use `uv run ruff format` to format changes. Use a focused `uv run pytest tests/test_*.py`
53
54
  selection while iterating, then complete the PR checks below. Offline CLI smoke:
@@ -4,6 +4,129 @@ All notable changes to `sdr-visualizer` will be documented here. The format foll
4
4
 
5
5
  ## [Unreleased]
6
6
 
7
+ ## [1.2.9] - 2026-11-12
8
+
9
+ ### Changed
10
+
11
+ - State in the README and on the project site that sdr-visualizer is not
12
+ affiliated with Adobe, and add a trademark notice.
13
+ - Replace the README's "public preview" label with a plain "Scope and limits"
14
+ section, and mark the package as production/stable on PyPI. The 1.x semantic
15
+ versioning promise is unchanged.
16
+ - Remove the 1.1.2 adapter review record from `docs/`. Its evidence stays in
17
+ pull request #41.
18
+ - Leave the maintainer-only Dependabot and release evidence documents out of
19
+ the source distribution.
20
+ - Maintainer tooling only: add a version-sync check and README badge, warm up
21
+ the browser before the first timed report in the performance gate, and
22
+ update the pytest and hypothesis development dependencies.
23
+
24
+ ## [1.2.8] - 2026-10-31
25
+
26
+ ### Fixed
27
+
28
+ - Treat a number too large to convert, such as a 400-digit
29
+ `complexity_score` or an infinite segment `nesting_depth`, as invalid input
30
+ (exit 3) instead of an unexpected error (exit 1). `--trend` skips such a
31
+ snapshot with a warning instead of stopping.
32
+ - Treat an `--at` value that its UTC offset pushes outside the supported date
33
+ range, and standard input that is not UTF-8, as invalid input (exit 3)
34
+ instead of an unexpected error. The stdin change matches sdr-grader.
35
+ - Skip a `*.json` entry whose file metadata cannot be read, such as a broken
36
+ symlink, when a directory is ordered by modification time. It no longer
37
+ stops the run, and it is still protected from being overwritten by an output.
38
+ - Stop error messages from repeating snapshot content. A record without an ID
39
+ is now reported by its list and position, such as `CJA metrics[3]`, instead
40
+ of by printing the whole record. Number errors name the value's type, not
41
+ the value. A failed live run reports the generator's exit status but no
42
+ longer prints its error output. These match sdr-grader.
43
+ - Leave out an AA calculated metric's `attribution` or `allocation` when it is
44
+ not a string, so the embedded payload and `--json` sidecar match
45
+ `docs/payload-schema.json`.
46
+ - Reject an HTML and `--json` destination pair whose names differ only in
47
+ letter case or Unicode normalization, in the same directory. On a
48
+ case-insensitive filesystem, such as the macOS default, the JSON used to
49
+ replace the report. A Workspace usage output or config path that reaches a
50
+ snapshot directory through a different letter case is now also rejected.
51
+ - Print "Workspace artifact writing interrupted" when Ctrl-C stops usage file
52
+ writing; the message was empty.
53
+ - Drop null, number, boolean and empty-string values from a component's tags
54
+ instead of turning them into tags such as `"None"` or `"7"`. Tag objects
55
+ still contribute their `name`, or else their `id`. This matches sdr-grader.
56
+ - Reject a definition, tag list or reference list whose embedded JSON repeats
57
+ a key within one object, as invalid input (exit 3), instead of keeping the
58
+ last value. Snapshot files already reject this. This matches sdr-grader.
59
+ - Report a snapshot directory that cannot be read as an input error. Before,
60
+ it looked like an empty directory. This matches sdr-grader.
61
+ - Decode standard input as UTF-8 whatever the terminal's locale encoding is.
62
+ This matches sdr-grader.
63
+ - Reject an empty `--dataview` or `--rsid` ID, or one that starts with `-`,
64
+ before running the generator (exit 3). The generator would read such a value
65
+ as an option. This matches sdr-grader.
66
+ - Detect an AA snapshot from the same `report_suite` key the AA adapter reads.
67
+ This matches sdr-grader.
68
+ - Treat a NaN or infinite component, derived field, calculated metric or
69
+ segment name, a component type, or an AA report suite name as missing,
70
+ instead of showing "nan". Spreadsheet-based exports write NaN for an empty
71
+ cell. This matches sdr-grader.
72
+ - `cja-lineage` now checks that the output's parent directory exists before
73
+ reading discovery input, and exits 3 as LINEAGE.md documents. It used to
74
+ exit 1 after discovery had already run.
75
+
76
+ ### Changed
77
+
78
+ - Advance the AA tested-through generator marker to `aa_auto_sdr` 1.24.6.
79
+ Snapshots that declare that version no longer print a newer-than-tested
80
+ warning. The CJA marker stays at `cja_auto_sdr` 3.13.6, the current release.
81
+ - Build reports faster. The check for invalid Unicode in snapshot text now
82
+ uses the same compiled pattern as sdr-grader. Median build time is 39% to
83
+ 46% lower across the synthetic performance tiers. Output is byte-identical.
84
+ - Maintainer tooling only: Dependabot auto-merge now also covers `pytest-xdist`
85
+ patch updates and `hypothesis` minor and patch updates. Every automatically
86
+ merged release must be at least 3 days old on PyPI, and Dependabot waits 3
87
+ days before opening `uv` update PRs.
88
+ - Maintainer tooling only: `uv.lock` now uses lockfile revision 5, which is the
89
+ format Dependabot writes, so Dependabot lockfile PRs no longer fail the
90
+ policy's settings check. No package versions changed.
91
+ - Maintainer tooling only: make tests independent of pytest 9.2.0 internals
92
+ and of machine load. One test no longer fakes `os.fstat` for the whole
93
+ process, two collection tests no longer depend on interpreter startup time,
94
+ and browser tests wait for results instead of sleeping.
95
+
96
+ ## [1.2.7] - 2026-10-30
97
+
98
+ ### Changed
99
+
100
+ - Advance the catalog tested-through generator markers to `cja_auto_sdr`
101
+ 3.13.6 and `aa_auto_sdr` 1.24.5. Snapshots that declare those versions no
102
+ longer print a newer-than-tested warning.
103
+ - Accept any `cja_auto_sdr` release at 3.11.8 or newer for live `cja-lineage`
104
+ discovery, instead of an exact list of versions. A version newer than 3.13.6,
105
+ the newest version exercised for this release, still runs and prints a
106
+ warning. Pre-release, local, or decorated version strings, other tools, and
107
+ versions older than 3.11.8 still fail closed before credentials are used.
108
+ Live output keeps the same shape validation as saved discovery.
109
+ - Reject a snapshot whose JSON repeats a key within one object, instead of
110
+ silently keeping the last value. This applies to snapshot files, stdin, live
111
+ generator output, comparison baselines, and trend members, and matches
112
+ sdr-grader. The error does not echo the key. A trend member with a repeated
113
+ key is skipped with a warning.
114
+ - Verify Python 3.13 in CI and list Python 3.11 through 3.14 in the package
115
+ classifiers. The installation requirement is still Python 3.11 or newer.
116
+ - Maintainer tooling only: CI pins uv 0.13.6, matching sdr-grader, so CI and
117
+ contributors resolve the lockfile with the same uv.
118
+ - Update the optional AA Workspace SDK to `aanalytics2==0.5.5.post3` and align
119
+ its collection version guard with the package pin. The upstream change is
120
+ limited to the knowledge graph module, which collection does not use.
121
+ - Speed up CI. Tests run in parallel with `pytest-xdist`, coverage is measured
122
+ once on Python 3.14, superseded pull request runs are cancelled, and every
123
+ job has a timeout. The `version-sync` check now runs inside the `lint`
124
+ workflow, and Pages publishes the committed examples.
125
+ - Allow a manual `release.yml` dry run that runs every release gate and the
126
+ build but skips the tag-version check, PyPI publication, and the GitHub
127
+ release. The workflow policy now requires that guard on `publish` whenever
128
+ the release workflow has a trigger other than a tag push.
129
+
7
130
  ## [1.2.6] - 2026-10-27
8
131
 
9
132
  ### Changed
@@ -781,7 +904,10 @@ The following are explicitly internal and may change without notice:
781
904
  - Workspace project visualization (v0.4)
782
905
  - Schema map view (v0.5)
783
906
 
784
- [Unreleased]: https://github.com/brian-a-au/sdr-visualizer/compare/v1.2.6...HEAD
907
+ [Unreleased]: https://github.com/brian-a-au/sdr-visualizer/compare/v1.2.9...HEAD
908
+ [1.2.9]: https://github.com/brian-a-au/sdr-visualizer/releases/tag/v1.2.9
909
+ [1.2.8]: https://github.com/brian-a-au/sdr-visualizer/releases/tag/v1.2.8
910
+ [1.2.7]: https://github.com/brian-a-au/sdr-visualizer/releases/tag/v1.2.7
785
911
  [1.2.6]: https://github.com/brian-a-au/sdr-visualizer/releases/tag/v1.2.6
786
912
  [1.2.5]: https://github.com/brian-a-au/sdr-visualizer/releases/tag/v1.2.5
787
913
  [1.2.4]: https://github.com/brian-a-au/sdr-visualizer/releases/tag/v1.2.4
@@ -1,6 +1,6 @@
1
1
  Metadata-Version: 2.5
2
2
  Name: sdr-visualizer
3
- Version: 1.2.6
3
+ Version: 1.2.9
4
4
  Summary: Static-output visual catalog generator for Adobe Customer Journey Analytics and Adobe Analytics implementations.
5
5
  Project-URL: Homepage, https://brian-a-au.github.io/sdr-visualizer/
6
6
  Project-URL: Documentation, https://github.com/brian-a-au/sdr-visualizer#documentation
@@ -11,10 +11,20 @@ Author: Brian Au
11
11
  License-Expression: MIT
12
12
  License-File: LICENSE
13
13
  License-File: THIRD_PARTY_LICENSES
14
+ Classifier: Development Status :: 5 - Production/Stable
15
+ Classifier: Environment :: Console
16
+ Classifier: Intended Audience :: Developers
17
+ Classifier: Programming Language :: Python :: 3
18
+ Classifier: Programming Language :: Python :: 3 :: Only
19
+ Classifier: Programming Language :: Python :: 3.11
20
+ Classifier: Programming Language :: Python :: 3.12
21
+ Classifier: Programming Language :: Python :: 3.13
22
+ Classifier: Programming Language :: Python :: 3.14
23
+ Classifier: Topic :: Scientific/Engineering :: Visualization
14
24
  Requires-Python: >=3.11
15
25
  Requires-Dist: jinja2>=3.1
16
26
  Provides-Extra: workspace-aa
17
- Requires-Dist: aanalytics2==0.5.5.post2; extra == 'workspace-aa'
27
+ Requires-Dist: aanalytics2==0.5.5.post3; extra == 'workspace-aa'
18
28
  Requires-Dist: requests>=2.32; extra == 'workspace-aa'
19
29
  Provides-Extra: workspace-cja
20
30
  Requires-Dist: cjapy==0.3.1; extra == 'workspace-cja'
@@ -60,21 +70,21 @@ Treat it as derived from the source snapshot. Move, email, post, or attach it
60
70
  only in authorized locations and in accordance with your organization's
61
71
  confidentiality and data-handling policy.
62
72
 
63
- ## Public preview scope
73
+ sdr-visualizer is an independent open source project. It is not affiliated
74
+ with, endorsed by, or supported by Adobe. See [Trademarks](#trademarks).
64
75
 
65
- This project is in public preview. A report describes what is configured in a
66
- snapshot. It does not grade the implementation, and it does not confirm that a
67
- configuration is correct, complete, or working at runtime. Review the details
68
- against the source implementation before you act on them.
76
+ ## Scope and limits
69
77
 
70
- The report embeds the supported normalized component catalog, not every
71
- platform-specific field. Optional Workspace project references are unverified
72
- candidates, and an empty result never means a component is unused. Keep the
73
- original generator snapshot for anything the report does not embed.
78
+ A report shows what a snapshot configures. It
79
+ does not grade the implementation or confirm that it works. Check the details
80
+ against the source implementation before you act on them.
74
81
 
75
- The tool is verified on Ubuntu with Python 3.11, 3.12, and 3.14. Other platforms
76
- and later Python versions are not yet verified. The package installs on Python
77
- 3.11 or newer.
82
+ - The report embeds the supported components, not every platform field. Keep the
83
+ original generator snapshot for anything the report does not embed.
84
+ - Workspace project references are unverified. An empty result does not mean a
85
+ component is unused.
86
+ - The tool is verified on Ubuntu with Python 3.11 through 3.14. It installs on
87
+ Python 3.11 or newer.
78
88
 
79
89
  ## Install
80
90
 
@@ -325,8 +335,9 @@ sidecar share one schema, published at
325
335
  and validated in CI against every payload shape produced by the bundled
326
336
  fixtures. Removing or retyping a field is major; adding optional fields is
327
337
  minor. The `segment_trees` / `formula_trees` node internals are documented in
328
- the schema as loosely specified. Current-generator and private-corpus
329
- validation is a separate, recorded release gate; see
338
+ the schema as loosely specified. Before each release, the maintainer also
339
+ checks the payload against fresh generator output and a private set of real
340
+ snapshots. Those snapshots contain customer data and are never published. See
330
341
  [`docs/RELEASING.md`](https://github.com/brian-a-au/sdr-visualizer/blob/main/docs/RELEASING.md).
331
342
 
332
343
  **CJA lineage.** `cja-lineage` adds a separate CJA-only command. Its documented
@@ -408,3 +419,13 @@ is governed by the [`CODE_OF_CONDUCT.md`](https://github.com/brian-a-au/sdr-visu
408
419
  MIT — see [`LICENSE`](https://github.com/brian-a-au/sdr-visualizer/blob/main/LICENSE). The output bundles [D3](https://d3js.org) v7,
409
420
  vendored under the ISC license; see
410
421
  [`THIRD_PARTY_LICENSES`](https://github.com/brian-a-au/sdr-visualizer/blob/main/THIRD_PARTY_LICENSES) for the full notice.
422
+
423
+ ## Trademarks
424
+
425
+ sdr-visualizer is an independent project. It is not affiliated with, endorsed
426
+ by, sponsored by, or supported by Adobe Inc. Adobe, Adobe Analytics, and
427
+ Customer Journey Analytics are trademarks or registered trademarks of Adobe
428
+ Inc. in the United States and other countries. This project uses those names
429
+ only to say which products its input comes from. For help with an Adobe
430
+ product, contact Adobe. For help with this tool, open an issue in this
431
+ repository.
@@ -37,21 +37,21 @@ Treat it as derived from the source snapshot. Move, email, post, or attach it
37
37
  only in authorized locations and in accordance with your organization's
38
38
  confidentiality and data-handling policy.
39
39
 
40
- ## Public preview scope
40
+ sdr-visualizer is an independent open source project. It is not affiliated
41
+ with, endorsed by, or supported by Adobe. See [Trademarks](#trademarks).
41
42
 
42
- This project is in public preview. A report describes what is configured in a
43
- snapshot. It does not grade the implementation, and it does not confirm that a
44
- configuration is correct, complete, or working at runtime. Review the details
45
- against the source implementation before you act on them.
43
+ ## Scope and limits
46
44
 
47
- The report embeds the supported normalized component catalog, not every
48
- platform-specific field. Optional Workspace project references are unverified
49
- candidates, and an empty result never means a component is unused. Keep the
50
- original generator snapshot for anything the report does not embed.
45
+ A report shows what a snapshot configures. It
46
+ does not grade the implementation or confirm that it works. Check the details
47
+ against the source implementation before you act on them.
51
48
 
52
- The tool is verified on Ubuntu with Python 3.11, 3.12, and 3.14. Other platforms
53
- and later Python versions are not yet verified. The package installs on Python
54
- 3.11 or newer.
49
+ - The report embeds the supported components, not every platform field. Keep the
50
+ original generator snapshot for anything the report does not embed.
51
+ - Workspace project references are unverified. An empty result does not mean a
52
+ component is unused.
53
+ - The tool is verified on Ubuntu with Python 3.11 through 3.14. It installs on
54
+ Python 3.11 or newer.
55
55
 
56
56
  ## Install
57
57
 
@@ -302,8 +302,9 @@ sidecar share one schema, published at
302
302
  and validated in CI against every payload shape produced by the bundled
303
303
  fixtures. Removing or retyping a field is major; adding optional fields is
304
304
  minor. The `segment_trees` / `formula_trees` node internals are documented in
305
- the schema as loosely specified. Current-generator and private-corpus
306
- validation is a separate, recorded release gate; see
305
+ the schema as loosely specified. Before each release, the maintainer also
306
+ checks the payload against fresh generator output and a private set of real
307
+ snapshots. Those snapshots contain customer data and are never published. See
307
308
  [`docs/RELEASING.md`](https://github.com/brian-a-au/sdr-visualizer/blob/main/docs/RELEASING.md).
308
309
 
309
310
  **CJA lineage.** `cja-lineage` adds a separate CJA-only command. Its documented
@@ -385,3 +386,13 @@ is governed by the [`CODE_OF_CONDUCT.md`](https://github.com/brian-a-au/sdr-visu
385
386
  MIT — see [`LICENSE`](https://github.com/brian-a-au/sdr-visualizer/blob/main/LICENSE). The output bundles [D3](https://d3js.org) v7,
386
387
  vendored under the ISC license; see
387
388
  [`THIRD_PARTY_LICENSES`](https://github.com/brian-a-au/sdr-visualizer/blob/main/THIRD_PARTY_LICENSES) for the full notice.
389
+
390
+ ## Trademarks
391
+
392
+ sdr-visualizer is an independent project. It is not affiliated with, endorsed
393
+ by, sponsored by, or supported by Adobe Inc. Adobe, Adobe Analytics, and
394
+ Customer Journey Analytics are trademarks or registered trademarks of Adobe
395
+ Inc. in the United States and other countries. This project uses those names
396
+ only to say which products its input comes from. For help with an Adobe
397
+ product, contact Adobe. For help with this tool, open an issue in this
398
+ repository.
@@ -167,31 +167,82 @@ The fixtures may diverge from sdr-grader's over time — the visualizer wants mo
167
167
  window-cap filtering (including an empty list for an empty directory) and
168
168
  maps discovery failures to `InvalidSnapshotError`.
169
169
  The grader mirrors this loader primitive even though it has no trend mode.
170
+ The grader also drops non-regular files here. The visualizer keeps them,
171
+ because a dangling symlink or `*.json` directory must stay a protected output
172
+ candidate; mtime-based selection skips a candidate whose metadata cannot be
173
+ read, with a warning (1.2.8).
174
+ - Record diagnostics — a malformed or ID-less record is reported by collection
175
+ and index (`CJA metrics[3]`, `AA segments[0]`) through `_record_context`,
176
+ never by echoing record content. Mirrored from sdr-grader `011b3d2` in 1.2.8.
177
+ - `input.shell_out` failure messages — a nonzero generator exit reports the
178
+ tool and exit status only; generator stderr is not echoed (sdr-grader
179
+ `011b3d2`). An empty or dash-leading `--dataview` / `--rsid` ID is rejected
180
+ before the generator starts, because it would be read as an option
181
+ (sdr-grader `90a9b3f`). The grader's capture byte limits and process-group
182
+ cleanup are not yet mirrored.
183
+ - `input.loader` stdin — stdin bytes are decoded as UTF-8 whatever the locale
184
+ encoding, and undecodable stdin is invalid input ("stdin is not valid UTF-8"),
185
+ mirrored from sdr-grader `2b18cd1` and `82c742e` in 1.2.8.
186
+ - `input.detect` — AA detection reads `report_suite` whenever that key is
187
+ present, the same key choice as the AA adapter (sdr-grader `5736d46`).
188
+ - `_present` — component, derived-field, calculated-metric and segment names
189
+ and component types (plus the AA report suite name) treat a non-finite float
190
+ as missing, because pandas writes NaN for an empty cell (sdr-grader `7cf980b`).
170
191
  - `_parse_tag_list` / `_parse_ref_list` — parse `tags` and reference fields
171
192
  that `cja_auto_sdr` ships as JSON-encoded list strings (`'["a"]'`) while
172
193
  tolerating native lists. Ordinary JSON syntax failures drop to `[]`;
173
194
  decoder resource failures raise `InvalidSnapshotError`. Every successful
174
195
  decode is limited to depth 100 and 10,000 nodes before shape fallback or
175
196
  coercion; this decoded-structure guard is part of the required sibling
176
- parity behavior.
197
+ parity behavior. A tag list keeps non-empty strings and the `name` (or else
198
+ `id`) of tag objects. Null, numbers, booleans and empty strings are dropped,
199
+ so they never count a component as tagged.
177
200
  - Snapshot structure validation rejects surrogate code points in string values
178
201
  and mapping keys before normalization. Embedded definition, tag, and
179
202
  reference helpers repeat that Unicode-scalar check after decoding, when
180
203
  escaped surrogates first materialize.
204
+ - `input/json_io.py` (`unique_object`, `DuplicateJSONKeyError`) — snapshot
205
+ files, stdin, and generator output reject a JSON object that repeats a member
206
+ name, mirrored from sdr-grader #127 (`c8e7316`). The helper body is
207
+ identical; only the module docstring differs. The embedded JSON in
208
+ definitions, tag lists and reference lists uses the same hook and raises
209
+ "<label> JSON contains duplicate object keys" (sdr-grader #156).
181
210
  - `_optional_list` (AA) — an absent/null optional section is `[]`, but a present non-list value raises `InvalidSnapshotError` (a malformed export, not an empty one). CJA gets the same guarantee through `_section_records`.
182
211
  - `generator_version_warning` / `_version_tuple` / `TESTED_THROUGH_GENERATOR_VERSION` — the Q5 version-compat warning mechanism (1.0.0). The helper bodies are behavior-identical; the constant's *value* is per-platform and per-release by design (the newest generator version that release was validated against).
183
212
  - `_optional_timestamp` — guards `created_at`/`modified_at`: keeps the value only if it's already a non-empty string, else `None`, so `_compact` drops a non-string timestamp (an epoch int, say) instead of leaking it into the payload. Present in both `cja.py` and `aa.py` here, and mirrored into the grader's copies of both adapters — a non-string timestamp is *missing*, not a value worth coercing to a numeric string.
184
213
  - `_optional_str` (CJA only) — guards `owner` and the derived-field `data_type` at the CJA record builders that previously passed them straight through unguarded (`str(x) if x else None`, the same pattern the metric/dimension `data_type` path already used). No grader-side mirror needed for `owner`: the grader's `_normalize_owner` (governance helper, see below) already reduces a non-string owner to `None` — a different mechanism, the same outcome — so grader `owner` needs no additional guard. AA needs no `_optional_str` mirror either: its three `owner_id` builder sites and its one `data_type` site were already cast (`str(x) if x else None`) before this cycle.
185
214
 
215
+ **Reviewed for 1.2.8 and not mirrored:** sdr-grader 1.7.0 also changed these
216
+ shared paths. Each is a deliberate project difference, not a missed defensive
217
+ fix:
218
+
219
+ - `49ed033` computes CJA segment `nesting_depth` from the definition's
220
+ containers so a grading threshold means the same on both platforms. The
221
+ visualizer describes the exported value, so it keeps `cja_auto_sdr`'s
222
+ `nesting_depth`.
223
+ - `f63704a` adds a grader warning for a degraded AA `fetch_status`. It is a new
224
+ diagnostic tied to grading findings, not input hardening.
225
+ - `0ceb788` and the earlier `19c9e94` accept a UTF-8 BOM. The visualizer still
226
+ rejects a BOM on file and stdin input alike; accepting it would widen input
227
+ acceptance and is left to a feature release.
228
+ - `2bed8a1` raises the grader's snapshot node budget to 1,000,000. The
229
+ visualizer's 250,000-node budget is its own published contract limit.
230
+
186
231
  **Grader-only (do not port — evaluative, not descriptive):** the grader carries logic that exists only to serve its grading rules — governance signals (`_governance_approved`, `_governance_shared_to_count`, `_normalize_owner`, `_aa_governance_signals`) and inline-echo de-duplication (`_echoes_derived_field`, which drops a metric/dimension that merely re-declares a derived field so rule SCH-001 doesn't false-fire on the duplicate name). The visualizer describes rather than grades: it keeps such echoes and instead warns on duplicate component ids (last-writer-wins for anatomy), so it never adopts these helpers.
187
232
 
188
233
  **Visualizer-only numeric coercion — intentional divergence, do NOT reconcile to the grader:** `_as_float` / `_as_int` are the visualizer's variant of the grader's tolerant `_safe_float` / `_safe_int`. Two deltas, both driven by visualizer-only features:
189
234
 
190
- 1. A present-but-unconvertible numeric **raises** `InvalidSnapshotError` (the grader defaults). Trend mode relies on the raise to *skip* a malformed snapshot rather than chart a fabricated value; a single snapshot exits 3.
235
+ 1. A present-but-unconvertible numeric **raises** `InvalidSnapshotError` (the grader defaults). Trend mode relies on the raise to *skip* a malformed snapshot rather than chart a fabricated value; a single snapshot exits 3. This includes values that overflow the conversion, such as a 400-digit integer or an infinite `nesting_depth` (1.2.8). The message names the value's type, not the value.
191
236
  2. `NaN` / `Infinity` **pass through** to the renderer's `allow_nan=False` guard, which rejects the whole report (audit H2). The grader coerces them to a default. A visualizer report that embeds `NaN` cannot boot in a browser, so rejecting loudly beats substituting `0.0`.
192
237
 
193
238
  These deltas are pinned by `test_nan_snapshot_exits_3`, `test_nan_in_snapshot_raises_invalid_snapshot_error`, and the trend bad-scalar skip test — a sync that "fixes" the divergence will fail them.
194
239
 
240
+ **AA calculated-metric attribution — intentional divergence:** the visualizer
241
+ keeps `attribution`/`attribution_model` and `allocation` only when they are
242
+ strings and otherwise omits them, so the payload matches its published schema
243
+ (1.2.8). The grader rejects a non-string attribution or allocation as invalid
244
+ input (sdr-grader #156).
245
+
195
246
  **Visualizer-only output protection — do not port to the grader:** before its
196
247
  first write, the visualizer compares both HTML and optional JSON destinations
197
248
  with every explicit snapshot and every directory candidate. Resolved paths and
@@ -237,4 +288,5 @@ Unlike the grader, the visualizer never treats an omitted built-in as an
237
288
  available node. Raw segment definitions remain outside snapshot comparison,
238
289
  and CJA comparison still uses exported formula summaries and reference arrays;
239
290
  this patch does not claim semantic equivalence checking for arbitrary ASTs.
240
- See [the adapter review](ADAPTER_CORRECTNESS_1.1.2.md) for evidence and limits.
291
+ The 1.1.2 review evidence is recorded in
292
+ [PR #41](https://github.com/brian-a-au/sdr-visualizer/pull/41).
@@ -42,15 +42,12 @@ cja-lineage --live --binary /absolute/path/to/cja_auto_sdr \
42
42
  Alternatively use `--profile profile-name`, or omit both credential selectors
43
43
  to use the upstream default credential route. `--profile` and `--config-file`
44
44
  are mutually exclusive and apply only to `--live`. The executable and explicit
45
- configuration paths must be absolute. Live discovery currently accepts exactly
46
- `cja_auto_sdr` 3.11.8, 3.12.0, 3.12.2, and 3.12.4. Other versions fail closed pending
47
- compatibility qualification; saved discovery is validated by shape rather than
48
- generator version. Version 3.12.2 was qualified against the offline discovery
49
- contract with synthetic inventories and blocked network access. That compatibility
50
- check does not qualify credentials, network behavior, or a live release. No
51
- generator is installed automatically. Version 3.12.4 was qualified with fresh
52
- read-only dataset discovery and saved-shape validation; this does not imply
53
- complete visibility into every dataset or Connection.
45
+ configuration paths must be absolute. Live discovery accepts
46
+ `cja_auto_sdr` 3.11.8 or newer, reported as a plain `X.Y.Z` version. Older
47
+ versions, pre-release or local builds, and other tools fail closed before
48
+ credentials are used. Versions newer than 3.13.6 run with a warning. Live and
49
+ saved discovery output are both validated by shape. No generator is installed
50
+ automatically.
54
51
 
55
52
  The command currently targets macOS and Linux, using POSIX process and
56
53
  owner-only output protections. Windows execution is not qualified. The generated
@@ -120,7 +117,7 @@ Keep live reports private to their authorized audience. The repository
120
117
  | `invalid-json` / `invalid-utf8` | Save complete UTF-8 JSON output, without terminal messages mixed into it. |
121
118
  | `saved-read-failed` | Check that the saved file exists and is readable. |
122
119
  | `executable-invalid` | Use an absolute, current-user-owned executable that is not group/world writable. |
123
- | `executable-version-mismatch` | Use a qualified upstream version listed above. |
120
+ | `executable-version-mismatch` | Use a `cja_auto_sdr` release at 3.11.8 or newer that reports a plain `X.Y.Z` version. |
124
121
  | `selector-invalid` | Check the profile or absolute configuration path and use one credential selector. |
125
122
  | `process-failed` / `timeout` | Check upstream authentication and discovery independently; acquisition has a 600-second limit. |
126
123
  | `saved-too-large` / `stdout-limit-exceeded` / `stderr-limit-exceeded` | Reduce the discovery scope; capture is bounded at 64 MiB for saved/stdout and 1 MiB for stderr. |
@@ -169,7 +169,10 @@ Build time is the median of three runs.
169
169
 
170
170
  `scripts/perf_browser_check.py` opens generated reports in headless Chromium
171
171
  through Playwright. It measures initial render time, cold and warm catalog
172
- filtering, and the main-thread pause when the graph initializes.
172
+ filtering, and the main-thread pause when the graph initializes. Every report
173
+ embeds the same JavaScript, so the browser compiles it once and reuses it. The
174
+ gate opens the first report once without timing it, so that one-time compile is
175
+ not charged only to whichever report happens to be measured first.
173
176
 
174
177
  The browser gate exercises all declared size tiers and enforces a 700 ms graph
175
178
  initialization cap, including a deterministic graph of roughly 1,000 nodes and
@@ -91,7 +91,9 @@ Before the first write, the visualizer verifies that the HTML and optional JSON
91
91
  destinations do not alias one another or any filesystem snapshot input. For a
92
92
  primary, baseline, or trend directory, every `*.json` candidate is protected,
93
93
  including corrupt, skipped, retained, and capped-out members. The check covers
94
- resolved paths, symlinks, symlinked parents, and existing hard links; a
94
+ resolved paths, symlinks, symlinked parents, existing hard links, and new
95
+ names in one directory that differ only in letter case or Unicode
96
+ normalization (which a case-insensitive filesystem stores as one file); a
95
97
  collision is invalid input and leaves source bytes unchanged.
96
98
 
97
99
  Offline is a transport property, not a confidentiality classification.
@@ -171,6 +173,12 @@ or coercion; decoder resource-limit failures and structure-limit violations
171
173
  are invalid input. Values decoded from embedded JSON are checked again because
172
174
  escaped surrogates first materialize at that boundary.
173
175
 
176
+ A JSON object that repeats a member name is invalid input, even when the
177
+ repeated values are identical. This applies to snapshot files, stdin, live
178
+ generator output, comparison baselines, and trend members. The error does not
179
+ echo the key or its values. A trend member with a repeated key is skipped with
180
+ a warning, like any other unreadable member.
181
+
174
182
  The graph includes directed edges only when both source and target exist.
175
183
  CJA-derived-field component references are normalized and contribute to those
176
184
  edges and degree counts. Dangling references do not create graph edges.
@@ -207,13 +215,14 @@ unusable, and capped-out members do not warn. The current markers are:
207
215
 
208
216
  | Platform | Warning threshold |
209
217
  |---|---:|
210
- | CJA (`cja_auto_sdr`) | 3.13.2 |
211
- | AA (`aa_auto_sdr`) | 1.24.1 |
218
+ | CJA (`cja_auto_sdr`) | 3.13.6 |
219
+ | AA (`aa_auto_sdr`) | 1.24.6 |
212
220
 
213
221
  A marker is evidence of exercised compatibility, not a promise about every
214
222
  possible snapshot produced by that version. It may advance only after a
215
223
  fresh, production-representative snapshot from that exact upstream version and
216
- the full historical private corpus pass the release checks in
224
+ the maintainer's private set of real historical snapshots pass the release
225
+ checks in
217
226
  [`RELEASING.md`](RELEASING.md). Bundled fixtures and CI do not replace that
218
227
  evidence.
219
228
 
@@ -289,7 +289,8 @@ Inspect repository settings immediately before the go/no-go decision and record
289
289
  the result:
290
290
 
291
291
  - `main` requires pull requests and the expected test/lint checks, including
292
- `test (3.11)`, `test (3.12)`, `test (3.14)`, and `browser-perf`;
292
+ `test (3.11)`, `test (3.12)`, `test (3.13)`, `test (3.14)`, and
293
+ `browser-perf`;
293
294
  - the candidate has successful `analyze (python, none)` and
294
295
  `analyze (javascript-typescript, none)` CodeQL checks, and `main` requires
295
296
  both emitted contexts before tag authorization;
@@ -310,7 +311,7 @@ the result:
310
311
 
311
312
  Inspect the emitted hosted check names and branch-protection/ruleset required
312
313
  contexts; editing the workflow does not update repository settings. Retain the
313
- established required contexts and add `test (3.14)` through the authorized
314
+ established required contexts and add `test (3.13)` and `test (3.14)` through the authorized
314
315
  hosted-control workflow. Record the settings inspection and exact-SHA run links.
315
316
  Each Python matrix lane must pass its runtime-version assertion, non-browser
316
317
  coverage gate, and Python performance gate. The test and release browser jobs,
@@ -332,7 +333,7 @@ non-critical item is backlog.
332
333
 
333
334
  ## Requirement evidence matrix
334
335
 
335
- Start from the tracked [release evidence template](RELEASE_EVIDENCE_TEMPLATE.md),
336
+ Start from the tracked [release evidence template](https://github.com/brian-a-au/sdr-visualizer/blob/main/docs/RELEASE_EVIDENCE_TEMPLATE.md),
336
337
  copy it into the release pull request, and replace every `pending` with durable
337
338
  evidence tied to the candidate SHA. The template is a copy source; this
338
339
  checklist remains authoritative.
@@ -437,6 +438,13 @@ versions, and one live generation path against the frozen candidate. Any drift
437
438
  from candidate evidence stops publication and requires complete
438
439
  requalification; it is not patched into the release after tagging.
439
440
 
441
+ Before tagging, a maintainer may dispatch `release.yml` manually on the
442
+ candidate commit (`gh workflow run release.yml --ref <branch>`) as a dry run.
443
+ It runs the browser and performance gates, the build, and the installed-artifact
444
+ smoke run, and it skips the tag-version check, PyPI publication, and the GitHub
445
+ release. A dry run's `dist` artifact is not the authoritative release artifact;
446
+ only the tag-triggered run produces that.
447
+
440
448
  After the candidate is approved, a separate explicit tag authorization starts
441
449
  the release workflow. Record the workflow run ID and attempt, event, tag,
442
450
  `headSha`, job conclusions, retained artifact ID, artifact expiry, distribution
@@ -183,7 +183,7 @@ bounded selection; an empty catalog cannot request collection.
183
183
 
184
184
  ## Collection behavior and limits
185
185
 
186
- Collection uses `cjapy==0.3.1` for CJA and `aanalytics2==0.5.5.post2` for AA.
186
+ Collection uses `cjapy==0.3.1` for CJA and `aanalytics2==0.5.5.post3` for AA.
187
187
  Each SDK's `findComponentsUsage` runs locally against sanitized fetched project
188
188
  definitions in a separate, credential-free process. Characterized helpers can
189
189
  miss structures or return false positives. **All SDK results remain unverified
@@ -1,19 +1,31 @@
1
1
  [project]
2
2
  name = "sdr-visualizer"
3
- version = "1.2.6"
3
+ version = "1.2.9"
4
4
  description = "Static-output visual catalog generator for Adobe Customer Journey Analytics and Adobe Analytics implementations."
5
5
  readme = "README.md"
6
6
  license = "MIT"
7
7
  license-files = ["LICENSE", "THIRD_PARTY_LICENSES"]
8
8
  authors = [{ name = "Brian Au" }]
9
9
  requires-python = ">=3.11"
10
+ classifiers = [
11
+ "Development Status :: 5 - Production/Stable",
12
+ "Environment :: Console",
13
+ "Intended Audience :: Developers",
14
+ "Programming Language :: Python :: 3",
15
+ "Programming Language :: Python :: 3 :: Only",
16
+ "Programming Language :: Python :: 3.11",
17
+ "Programming Language :: Python :: 3.12",
18
+ "Programming Language :: Python :: 3.13",
19
+ "Programming Language :: Python :: 3.14",
20
+ "Topic :: Scientific/Engineering :: Visualization",
21
+ ]
10
22
  dependencies = [
11
23
  "jinja2>=3.1",
12
24
  ]
13
25
 
14
26
  [project.optional-dependencies]
15
27
  workspace-cja = ["cjapy==0.3.1", "requests>=2.32"]
16
- workspace-aa = ["aanalytics2==0.5.5.post2", "requests>=2.32"]
28
+ workspace-aa = ["aanalytics2==0.5.5.post3", "requests>=2.32"]
17
29
 
18
30
  [project.scripts]
19
31
  sdr-visualizer = "sdr_visualizer.cli.main:main"
@@ -35,6 +47,7 @@ dev = [
35
47
  "jsonschema>=4.21",
36
48
  "pytest-cov>=5.0",
37
49
  "pyyaml>=6.0",
50
+ "pytest-xdist>=3.8.0",
38
51
  ]
39
52
  browser = [
40
53
  "playwright>=1.43",
@@ -72,6 +85,8 @@ exclude = [
72
85
  "tests/fixtures/cja_snapshot_large.json",
73
86
  "tests/fixtures/cja_snapshot_xl.json",
74
87
  "tests/fixtures/aa_snapshot_large.json",
88
+ "docs/DEPENDABOT_AUTOMATION.md",
89
+ "docs/RELEASE_EVIDENCE_TEMPLATE.md",
75
90
  ]
76
91
 
77
92
  [tool.pytest.ini_options]
@@ -29,6 +29,9 @@ EXPECTED_CODEQL_MATRIX = {
29
29
  }
30
30
  EXPECTED_CODEQL_CONFIG_FILE = "./.github/codeql/codeql-config.yml"
31
31
  EXPECTED_CODEQL_IGNORES = ["examples/**"]
32
+ # The one job guard release.yml may use: it skips publication on manual dry
33
+ # runs and, lacking a status function, still implies success().
34
+ RELEASE_PUBLISH_GUARD = "github.event_name == 'push'"
32
35
 
33
36
 
34
37
  def _error(path: Path, message: str) -> str:
@@ -243,12 +246,26 @@ def _release_errors(path: Path, workflow: dict[str, Any]) -> list[str]:
243
246
  errors.append(_error(path, "github-release must need publish"))
244
247
  for job_name, job in jobs.items():
245
248
  if isinstance(job, dict):
249
+ item = job
250
+ if job_name == "publish" and job.get("if") == RELEASE_PUBLISH_GUARD:
251
+ item = {key: value for key, value in job.items() if key != "if"}
246
252
  _require_default_success(
247
253
  errors,
248
254
  path=path,
249
255
  label=f"job {job_name!r}",
250
- item=job,
256
+ item=item,
251
257
  )
258
+ # PyYAML reads the bare `on` key as boolean True.
259
+ triggers = workflow.get("on", workflow.get(True))
260
+ trigger_names = set(triggers) if isinstance(triggers, (dict, list)) else {triggers}
261
+ if trigger_names != {"push"} and publish.get("if") != RELEASE_PUBLISH_GUARD:
262
+ errors.append(
263
+ _error(
264
+ path,
265
+ f"publish must use 'if: {RELEASE_PUBLISH_GUARD}' when release has "
266
+ "triggers other than push",
267
+ )
268
+ )
252
269
 
253
270
  build_distribution = _step_index(
254
271
  build, lambda step: _run_is(step, "uv build --out-dir dist/packages")