Skip to content

Conversation

@ahouseholder
Copy link
Contributor

@ahouseholder ahouseholder commented Aug 18, 2025

This PR adds tools to generate a mermaid diagram from a DecisionTable object.
It also adds a method that lets us generate the markdown table format directly from the DecisionTable object instead
of loading a .csv file.

The main changes can be found in src/ssvc/decision_tables/helpers.py. Everything else is incidental.

Note

mermaid has a default limit of 500 edges per diagram to prevent unreasonably long browser load times. In this implementation, we first attempt to generate a single diagram. If the edge count exceeds the limit, we split it across the first decision point values (each one gets its own diagram). So far this is sufficient for all the decisions we currently have models for. If we need a more robust solution later, we can address this in a future PR.

Incidental changes

  • Update the COORDINATE decision point to better reflect existing documentation.
  • Update existing decision model docs to leverage new features available from DecisionTable implementation.
Screenshot 2025-08-18 at 2 59 03 PM Screenshot 2025-08-18 at 2 59 10 PM

Copilot Summary

This pull request updates the SSVC "Decline, Track, Coordinate" decision point to version 1.0.1 and ensures the coordinator triage decision table uses the latest version and improved descriptions. The changes primarily focus on updating references and descriptions for clarity and consistency.

Decision point versioning and descriptions:

  • Added a new decision point definition file ssvc/decline_track_coordinate_1_0_1.json for version 1.0.1, with expanded descriptions for the "Decline," "Track," and "Coordinate" outcomes.
  • Updated the coordinator_triage_1_0_0.json decision table to reference ssvc:COORDINATE:1.0.1 instead of 1.0.0, and replaced the outcome descriptions with the more detailed text from the new version.

Reference updates throughout the decision table:

@ahouseholder ahouseholder added this to the 2025-09 milestone Aug 18, 2025
@ahouseholder ahouseholder added enhancement New feature or request python Pull requests that update Python code content/representation Formatting, page layout, syntax, etc. tech/backend Back-end tools, code, infrastructure labels Aug 18, 2025
@ahouseholder ahouseholder self-assigned this Aug 18, 2025
@ahouseholder
Copy link
Contributor Author

Closing to reopen from main repo

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

content/representation Formatting, page layout, syntax, etc. enhancement New feature or request python Pull requests that update Python code tech/backend Back-end tools, code, infrastructure

Projects

None yet

1 participant