fix: readable_from_unique_id handles prefixed IDs from generate_unique_id

[Copilot]

readable_from_unique_id always parsed with %Y%m%d_%H%M%S_%f, crashing with ValueError on any ID produced by generate_unique_id(prefix=...) (e.g. "test_20260413_140000_123456").

Fix — src/voxkit/storage/utils.py

• Scan underscore-delimited parts for the first 8-digit segment to locate the date, stripping any leading prefix before parsing.
• Add for/else to raise a descriptive ValueError("No valid timestamp found in unique ID: ...") instead of a cryptic strptime failure when no date segment exists.
• Updated docstring to document both plain and prefixed ID forms.

# Now works for both:
readable_from_unique_id("20260413_140000_123456")        # plain
readable_from_unique_id("test_20260413_140000_123456")   # prefixed

Tests — tests/storage/test_utils.py

Three new cases in TestReadableFromUniqueId:

• Live round-trip via generate_unique_id(prefix="test")
• Asserts prefixed and plain IDs with identical timestamps produce equal output
• Asserts descriptive ValueError on input with no recognisable timestamp

Release Branch PR

Target Release:

Changes

• readable_from_unique_id now strips optional <prefix>_ segments before timestamp parsing
• Raises descriptive ValueError when no 8-digit date segment is found
• Docstring updated to reflect accepted input formats
• Three new unit tests covering prefixed round-trip and invalid input

Testing

• Test testable logic
• Edge cases addressed

Testing Notes: Validated plain IDs, prefixed IDs, and malformed input (no date segment). Ruff lint/format clean.

Documentation

• README updated (if applicable)
• Code comments added/updated
• User-facing documentation updated (if applicable)

Documentation Notes: Docstring on readable_from_unique_id updated to document [prefix_]YYYYMMDD_HHMMSS_ffffff input format.

Checklist

• Code follows project conventions
• No breaking changes (or documented if intentional)
• All CI checks pass

Warning

Firewall rules blocked me from connecting to one or more addresses (expand for details)

I tried to connect to the following addresses, but was blocked by firewall rules:

• releases.astral.sh
  • Triggering command: /home/REDACTED/.local/bin/uv uv run invoke run-tests (dns block)

If you need me to access, download, or install something from one of these locations, you can either:

• Configure Actions setup steps to set up my environment, which run before the firewall is enabled
• Add the appropriate URLs or hosts to the custom allowlist in this repository's Copilot coding agent settings (admins only)