Tags

A new feature has landed: **`Data Store`**. This feature enables users to visualize
the progression of each expectation as a graph. Additionally, users can now
**slice the graph directly from the CLI** for more targeted insights.

This release also includes several **user experience improvements to the
`trudag` tool**.

- **Trudag Tool Enhancements**

- Nodes and edges are now organized by **name** and **source name**
- Introduced the new **`Data Store`** feature:
  - Graphical view of expectations
- CLI-based graph slicing
- Added more tests:
  - Including coverage for the `publish` command
- **Publish** command improvements:
  - Now runs faster
  - Outputs only SVG images
- Matrix calculations are now more efficient
- Removed **mutable object** from constructor interface
- Improved tracebacks for **validators** and **reference plugins**

- Documentation
  - Clarified behavior of **"inputs"**
  - Fixed pinned links in the **NEWS** section

- CI Pipeline Improvements
  - Fixed issues in linting stage
  - Added more tests
  - Added **Markdown linting**

- Misc
  - Fixed a known issue related to a hidden **Python 3.13** dependency

- All `trudag` commands require a **GitLab auth token** if a
  `public: false` reference of `type: gitlab` is present in the tree.
-----BEGIN SSH SIGNATURE-----
U1NIU0lHAAAAAQAAADMAAAALc3NoLWVkMjU1MTkAAAAgJMFmVa903AQjUIzlIygotrA/68
koz2cFuOPw9aVUW+8AAAADZ2l0AAAAAAAAAAZzaGE1MTIAAABTAAAAC3NzaC1lZDI1NTE5
AAAAQFS5cjzuLrvoOXbKDmKDm4xwzS/bn8BryP0D9QPfatPMhO5bPOWn6TDuIqKMAHfIdR
vV3M8np9PC+ktgnVPsTgE=
-----END SSH SIGNATURE-----

Documentation improvements, ongoing implementation of dotstop (TSF-specific replacement for Doorstop) and documentation on the RAFIA process.

### Change Summary

- Added API references for trustable_compliance, graphalyzer and dotstop
- Added Lint and format checks using ruff
- Progess on implementation of dotstop
    - Read and write dotstop graphs and items natively from files
    - Reference management and reference plug-in support, including unit tests
    - YAML front matter schema
- Improved guidance for TA-MISBEHAVIOURS and associated glossary definitions
- RAFIA process documentation, illustrating some specific applications of TSF
- Renamed and expanded the TAs

Improved user instructions

### Changes

- Improved tool and getting started documentation
- Guidance on organisation of items and graphs
- Clarifications and improved guidance for TA items
- Criteria for SME assessments
- Clarified documentation about review and the review status field
- Small TSF tool improvements, including graduated colour maps for scores

## Known issues

* See list for previous release (unchanged)

Release of project in preparation for public launch.

### Changes

- Added licenses for documentation and tools
- Removed deprecated validator code
- Improved release job to publish package in project PyPi via twine
- Improved readability for text on coloured background in compliance report

## Known issues

* Mermaid diagram rendering is broken in the Compliance documentation
* Needs guidance on how to:
    - Import existing requirements into a TSF graph
    - Integrate TSF graphs from other projects
* Missing API reference pages for `trustable-compliance`
- Support for multi-repository usage of TSF is *experimental only* and
  has a number of known issues (see compliance/remote.md#pitfalls)

Interim release of project in its new context on gitlab.com

### Changes

* CI and tooling updated to build for the new context
* Theme and document generation configuration updated to a Trustable theme

### Resolved issues

* Guidance for TA-18 and TA-20 needs adding

### Known issues

* Mermaid diagram rendering is broken in the Compliance documentation
* Needs guidance on how to:
    - Import existing requirements into a TSF graph
    - Integrate TSF graphs from other projects
* Missing API reference pages for `trustable-compliance`
- Support for multi-repository usage of TSF is *experimental only* and
  has a number of known issues( see compliance/remote.md#pitfalls)

RC2 to verify that releasing issue is resolved

Release candidate to verify release procedure in the project's new context

Further refinement of the methodology, tooling to support confidence scoring
and a refactoring of the Trustable Assertions to align with the TSF graph model.

### Changes

* Tooling extended and improved to support:
    - New 'dotstop' interface layer to support new graph model design in future
    - Restructured Trustable report
* Documentation extended and improved to:
    - Design concept description for 'dotstop'
    - Refined requirements management process
    - Expanded and improved methodology
* Trustable Assertions and Tenets updated to:
    - Separate informative (guidance) from normative (Statements) text
    - Change TA UIDs to define a new 'series', with a series identifier (A)
      and a new numerical sequence for the Items

### Known issues

* Needs guidance on how to:
    - Import existing requirements into a TSF graph
    - Integrate TSF graphs from other projects
* Missing API reference pages for `trustable-compliance`
* Guidance for TA-18 and TA-20 needs adding
- Support for multi-repository usage of TSF is *experimental only* and
  has a number of [known issues](compliance/remote.md#pitfalls)

Release candidate for v2025.01.24

TSF Release v2024.12.19

Further refinement of the methodology, tooling to support confidence scoring and a refactoring of the Trustable Assertions to align with the TSF graph model.

## Changes

- Tooling extended and improved to support:
    -  Autogenerate the Trustable Tenets and Assertions diagram from Doorstop Items
    - Add support for aggregating confidence scores from Doorstop Items
    - Inclusion of inlined Artifacts in the Trustable Report 
- Documentation extended and improved to:
    - Clarify and refine the methodology, adding diagrams to illustrate the TSF graph model
    - Provide detailed instructions for creating, storing, and managing a TSF graph
    - Refactor the Trustable Assertions to address identified problems and align their relationships with the TSF graph logic

## Resolved issues

- Guidance added to documentation for how to:
    - Integrate the Trustable TSF graph into a project
    - Update a TSF graph when evidence changes

## Known issues

- Needs guidance on how to:
    - Import existing requirements into a TSF graph 
    - Integrate TSF graphs from other projects
- Missing API reference pages for trustable-compliance
- Guidance for TA-18 and TA-20 needs adding
- Support for multi-repository usage of TSF is experimental only and has a number of known issues