Skip to contents

Derive structural grouping heuristics from relative paths

derive_structural_groups.Rd

Derives lightweight structural grouping heuristics from relative filesystem paths.

Usage

derive_structural_groups(rel_path)

Arguments

rel_path

Character vector of relative filesystem paths.

Value

A data.frame with columns:

structural_group

Filesystem-based structural grouping heuristic derived from the first path component.

component

Immediate structural subdivision within the grouping, if present.

Details

The function extracts shallow structural patterns commonly found in software projects, research workflows, and digital working environments.

It assigns:

  • structural_group: grouping heuristic derived from the first path component (e.g. innolab25, _packages, _markdown)

  • component: immediate structural subdivision within the grouping, if present (e.g. eviota, filmledgerimport, iotables)

These derived structures support:

  • exploratory grouping of filesystem observations

  • navigation of large observational snapshots

  • reconstruction of operational project environments

  • identification of candidate documentary aggregations

The function performs deterministic structural projection only. It does not validate repository semantics, documentary structure, or authoritative Record Set boundaries.

This function provides a lightweight structural interpretation layer on top of observational filesystem data.

In RiC-aligned operational terms:

  • rows in observational snapshots represent filesystem Instantiations

  • rel_path acts as an operational locator associated with observed filesystem occurrences

  • the derived structural groupings provide analytical heuristics that may later support Record Set construction

The derived groupings are operational analytical projections, not authoritative RiC Record Sets.

The function is intended for analytical, navigational, and exploratory reconstruction workflows.

Future versions of the package may replace or extend this logic with more explicit provenance-aware Record Set construction workflows (for example via create_record_set()).