OCDocker.Workbench.Artifacts module

Read-only artifact indexing helpers for Workbench result browsing.

OCDocker.Workbench.Artifacts.build_artifact_index(root, *, kinds=None, roles=None, require_existing=False, max_depth=6)[source]

Build a read-only cross-run artifact index from Workbench manifests.

Parameters:

  • root (str or pathlib.Path) – Workspace root or manifest file to scan.

  • kinds (tuple[str, ...] or list[str] or None) – Optional artifact kinds to include.

  • roles (tuple[str, ...] or list[str] or None) – Optional artifact roles to include.

  • require_existing (bool) – If True, include only artifacts that currently exist on disk.

  • max_depth (int) – Maximum directory depth below root to scan.

Returns:

Artifact browser payload for GUI, CLI, and automation consumers.

Return type:

WorkbenchArtifactIndex