Artefacts
Create, edit, and manage source-of-truth artefacts in the Source Library.
An artefact is a source-of-truth row inside a Source Library source. Requirements, hazards, verification cases, evidence items, glossary terms, and standards clauses are all artefacts when they live in a source.
Artefacts have a stable identifier, typed field values, optional artefact kind metadata, version history, comments, reviews, and traceability links.
Create an artefact
Open a source in the Source Library and create a new row. If the source has an identifier prefix, Integrity generates the next available identifier for that source, such as REQ-001.
Generated identifiers are checked against the whole workspace before creation. If another source already owns the next identifier, Integrity skips unsafe generated values or blocks creation with friendly copy so duplicate identifiers are not created.
Artefact identifiers are immutable after creation. Edit the artefact's fields when content changes; create a new artefact if the source-of-truth identifier itself would need to change.
Workspace-wide identifiers
Identifiers are unique across the workspace, not only inside one source. Integrity normalizes casing and whitespace when checking uniqueness, so REQ-001, req-001, and REQ-001 are treated as the same identifier.
This matters because identifiers are used across imports, traceability, reviews, baselines, and audit history. Reusing the same identifier in two sources would make it unclear which artefact a link, import row, or evidence record refers to.
Prefixes and counters
A source prefix is the short code used for generated identifiers. A Requirements source might use REQ; a Hazard Log might use HAZ.
Prefixes help teams read identifiers, but the full identifier is the unique key. If two sources share a prefix, Integrity can warn admins to review the setup. That warning is different from a duplicate full identifier:
| Condition | Result |
|---|---|
| Duplicate full identifier | Critical health issue; creation/import should be blocked |
| Next generated identifier already exists | Critical health issue; generation setup needs attention |
| Missing prefix for generated identifiers | Blocks generated creation until a prefix exists |
| Shared prefix | Warning or informational review unless it creates a real collision |
| Legacy or custom identifier prefix | Informational review; blocks prefix changes until every artefact matches the current prefix-number pattern |
| Counter drift | Warning or blocker depending on whether the next generated value would collide |
Duplicate artefacts
When you duplicate one artefact or duplicate a selection in bulk, Integrity generates new workspace-safe identifiers for the copies. The copies keep the same field values, but they do not reuse the original identifier.
If generation is unsafe because the source has no prefix or its next identifier would collide, Integrity blocks the duplicate action with friendly copy instead of showing raw database errors.
Importing artefacts
Imports use the same workspace-wide identifier rules. When you import into an existing source, rows whose identifiers already exist in that target source can be treated as update candidates. Rows whose identifiers belong to another source are blocking collisions and must be changed before creating new artefacts.
See Import & Export for the import preview and readiness flow.
Work in the artefact table
Open a source or saved source view in Modules to work with its artefacts. Table mode keeps search, filters, display options, Table/Tree/Matrix switching, and pagination in the Modules header area while the Source Library continues to own the source data, field definitions, permissions, and saved view state.
Search is committed instead of refetching on every keystroke, which keeps large sources responsive. Filters can target system columns such as kind, review status, reviewers, links, and source fields. Display options control visible properties, grouping, ordering, and the active presentation mode. Large sources stay page-based, so use the footer to move between pages rather than expecting all artefacts to load at once.
Saved source views appear as view pills above the table. A new view starts as a local draft and is only created when you save it. Existing views can save their current search, filters, display options, visible properties, and presentation mode when you have permission to manage the source.
Artefact row selection uses the same floating selection surface as other workspace object tables while preserving Source Library bulk semantics. You can select visible rows, Ctrl-click a row (Cmd-click on macOS) to toggle only that row, use Shift-click ranges, select the current page or all matching results, and then run supported existing actions such as duplicate, export, bulk edit, or move to trash. Selection itself is temporary; it does not change saved source views, source defaults, filters, pagination, or copied URLs.
Open artefact details
Clicking an artefact row opens the focused artefact detail page without leaving the Modules family. The center area shows the artefact identity and the Activity, Links, and History views. On Activity and Links, the right drawer shows display-safe Properties and Review status. On History, the right drawer shows Version History while field labels and values stay in the center content area. The initial field values and any future create-time links remain part of version 1, while Activity presents one concise creation row instead of treating that initial state as later changes. An already-existing linked counterpart may still record that it gained the link. The row action menu is separate from row selection, so actions such as copying a link do not also open the artefact.
Restricted or direct-shared artefacts only show the details your access allows. If parent source or folder context is hidden from you, the detail view and drawer avoid exposing hidden names, identifiers, colors, field labels, and counts.
Artefact detail URLs use the workspace-unique artefact identifier, such as /workspace/{workspace-url}/artefacts/REQ-001. Existing raw-id links redirect through the same access check when the artefact is visible to you. Copy URL copies the current readable artefact URL and stays unavailable for hidden or unavailable artefacts.
Identifier health
The Integrity area reports identifier health alongside other workspace findings. It summarizes duplicate identifiers, import collision risks, missing prefixes, counter drift, and generation issues without exposing restricted source detail to users who cannot access those sources.