Conversation
Updated
README
- Refreshes the main project overview
- Describes the current workspace-based workflow
- Adds workspace export and playback examples
- Documents interactive workspace and timeline selection
- Keeps direct file export as an explicit alternative
- Adds workspace timeline storage layout
- Links to the CLI and development documentation
Documentation
- Adds the main Docs index
- Adds CLI docs split by command area
- Adds workspace, export, organization and auth guides
- Adds development setup and validation docs
- Adds project structure documentation
- Adds developer debug command documentation
- Documents the top-level Tests project layout
Result
These changes align the documentation with the current CLI, workspace timeline storage, local development flow and test project layout.
Store generated .gittrace files under the currently selected workspace instead of treating exports as standalone output files only.
Added
Export flow
- Resolves the currently active workspace from IWorkspaceContext
- Updates export logic to save generated timeline data under the active workspace
- Preserves explicit --output/-o fallback behavior
- Adds validation to fail gracefully when no workspace is selected
Workspace storage
- Adds WorkspaceTimelineStorage to handle predictable workspace specific paths
- Saves WorkspaceTimelineMetadata sidecar files to identify repository sources
- Implements listing of stored timeline files for a workspace
CLI integration
- Adds WorkTimelinesCommand for listing workspace timelines
- Adds WorkTimelinesCommandHandler to present timeline metadata in an organized table
- Adds tests for workspace aware export path resolution
Result
These changes make timeline exports workspace-aware, organizing generated .gittrace files automatically and providing the foundation to easily list and reuse them for workspace specific history views.
github-actions
Bot
added
documentation
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
1 participant
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
Summary
Introduce workspace managed timeline storage and playback workflow.
Added
ws currentws timelinesws playDocs/GuidesDocs/DevelopmentChanged
exportnow stores timelines in the active workspace when--outputis omittedworkspace usesupports interactive selectionwsalias forworkspaceorganizationalias fororgFixed
--orgrequirement from workspace listingDocumentation
Result
ChangeTrace now supports complete workspace oriented workflow where exports, timeline storage, timeline discovery and playback are managed through workspaces instead of requiring manual file paths.
Validation
Build
dotnet build ChangeTrace.slnxTests
dotnet test Tests/ChangeTrace.Tests.csproj --no-buildManual
Breaking Changes
exportno longer defaults totimeline.gittracewhen--outputis omitted.Linked Issues
#16 - Store .gittrace files under selected workspace context