← All projects
11

Developer tools · workspace inspection

WSP

An independent Go CLI that normalizes Git and filesystem facts into inspectable workspace relationships.

Public release v0.2.0
Period
2026 — present
Role
Tool developer

PROJECT / DECISION RECORD

From the problem to the implementation

  1. 01Problem

    Directory names and repository adjacency are not reliable semantic workspace identities.

  2. 02Design decision

    Separate adapters, normalized identities, relations, inspector and presentation lenses.

  3. 03Implementation

    Go CLI for workspace initialization, repository inspection, and logical/physical tree lenses.

Structured from project notes; not a live product screen or an execution test.

Problem

11

Directory names and repository adjacency are not reliable semantic workspace identities.

WSP / read-only workspace inspection

  1. 01 / ObserveGit · Filesystem

    Read physical repositories and directories.

  2. 02 / NormalizeWorkspace Relations

    Organize observed facts into workspace relationships.

  3. 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

Source evidenceObserved

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.

Current statusPublic release v0.2.0

Related projects