Developer tools · workspace inspection
WSP
An independent Go CLI that normalizes Git and filesystem facts into inspectable workspace relationships.
- Period
- 2026 — present
- Role
- Tool developer
PROJECT / DECISION RECORD
From the problem to the implementation
- 01Problem
Directory names and repository adjacency are not reliable semantic workspace identities.
- 02Design decision
Separate adapters, normalized identities, relations, inspector and presentation lenses.
- 03Implementation
Go CLI for workspace initialization, repository inspection, and logical/physical tree lenses.
Problem
11Directory names and repository adjacency are not reliable semantic workspace identities.
WSP / read-only workspace inspection
- 01 / ObserveGit · Filesystem
Read physical repositories and directories.
- 02 / NormalizeWorkspace Relations
Organize observed facts into workspace relationships.
- 03 / InspectInspector · Lens
Explore logical/physical trees and detail views.
Based on documented source responsibilities; no mutation or execution commands are implied.
Constraints
- The Git adapter remains read-only: no repair, deployment, promotion or authority changes.
- Keep observed Git state distinct from user-defined workspace semantics.
- Inspection must not mutate worktrees or branches.
Engineering decisions
- Separate adapters, normalized identities, relations, inspector and presentation lenses.
- Normalize physical facts without dropping source provenance.
- Keep tree projections and detailed inspection as separate lenses.
Implementation
- Go CLI for workspace initialization, repository inspection, and logical/physical tree lenses.
- Use the documented Git adapter and logical/physical workspace tree inspection.
- Leave mutation, approvals and execution authority to Workspace Ops.
Verification / evidence
The WSP README and Go module document v0.2.0 and read-only inspection commands.
Result / current state
Public v0.2.0 release with a read-only contract distinct from Workspace Ops.