Enhance workspace navigation, visuals, and diff management

.air.toml

@@ -3,9 +3,9 @@ testdata_dir = "testdata"
 tmp_dir = "tmp"
 
 [build]
-  args_bin = ["serve"]
-  bin = "./tmp/main"
-  cmd = "go build -o ./tmp/main ./cmd/tld"
+  args_bin = ["watch"]
+  bin = "./tmp/tlddebug"
+  cmd = "go build -o ./tmp/tlddebug ./cmd/tld"
   delay = 1000
   exclude_dir = ["assets", "tmp", "vendor", "frontend", "data"]
   exclude_file = []

.github/workflows/test.yml

@@ -8,6 +8,7 @@ on:
 
 permissions:
   contents: read
+  checks: write
 
 jobs:
   test:
@@ -49,11 +50,16 @@ jobs:
           git diff --exit-code
 
       - name: Run unit tests with race detection
-        run: go test -race -shuffle=on -coverprofile=coverage.txt ./...
+        run: |
+          go install gotest.tools/gotestsum@latest
+          gotestsum \
+            --junitfile results.xml \
+            --format testdox \
+            ./...
 
-      - name: Upload coverage reports to Codecov
-        uses: codecov/codecov-action@v5
+      - name: Publish Test Results
+        uses: dorny/test-reporter@v1
         with:
-          token: ${{ secrets.CODECOV_TOKEN }}
-          file: ./coverage.txt
-          fail_ci_if_error: false
+          name: Go Tests
+          path: results.xml
+          reporter: java-junit

.gitignore

@@ -4,3 +4,5 @@ frontend/public
 tmp
 frontend/*.tgz
 .agents
+.claude/skills/impeccable
+skills-lock.json

Makefile

@@ -1,4 +1,4 @@
-.PHONY: frontend-deps frontend-build lint-be lint-fe build run clean dev test-backend build-go setup-hooks make-be make-fe
+.PHONY: frontend-deps frontend-build lint-be lint-fe build run clean dev dev-stop test-backend build-go setup-hooks make-be make-fe
 
 setup-hooks:
 	chmod +x scripts/pre-commit.sh
@@ -28,6 +28,10 @@ dev:
 	@echo "Starting development stack..."
 	@$(MAKE) -j 2 be fe
 
+dev-stop:
+	@echo "Stopping development backend..."
+	-pkill -x tlddebug
+
 proto: ## Update go.mod to latest BSR-published proto versions (run after buf push in proto/)
 	go get buf.build/gen/go/tldiagramcom/diagram/protocolbuffers/go@$(shell buf registry sdk version --module=buf.build/tldiagramcom/diagram --plugin=buf.build/protocolbuffers/go)
 	go get buf.build/gen/go/tldiagramcom/diagram/connectrpc/go@$(shell buf registry sdk version --module=buf.build/tldiagramcom/diagram --plugin=buf.build/connectrpc/go)

README.md

@@ -1,8 +1,8 @@
-# tld
+[![Logo](./frontend/logo/tld.svg)](https://tldiagram.com)
 
 [![Go Version](https://img.shields.io/github/go-mod/go-version/mertcikla/tld)](https://go.dev/) [![License](https://img.shields.io/github/license/mertcikla/tld)](./LICENSE) [![Build Status](https://img.shields.io/github/actions/workflow/status/mertcikla/tld/test.yml?branch=main)](https://github.com/mertcikla/tld/actions) [![Go Report Card](https://goreportcard.com/badge/github.com/mertcikla/tld)](https://goreportcard.com/report/github.com/mertcikla/tld)
 
-`tld` provides a complete software architecture management platform that bundles a high-performance Go backend with an interactive React frontend into a single, standalone binary. Includes a CLI to enable managing diagrams from the shell or in CI.
+`tld` provides a complete software architecture management platform that bundles a high-performance Go backend with an interactive React frontend into a single, standalone binary. Includes a CLI to enable managing diagrams from the shell or in CI. 
 
 Designed for local-first development and private self-hosting, `tld` allows teams to visualize, document, and manage their system architecture using a combination of a rich web UI and "Diagrams as Code" workflows.
 
@@ -11,6 +11,7 @@ Designed for local-first development and private self-hosting, `tld` allows team
 ## Key Features
 
 - **Full-Featured Web UI**: A React frontend designed, polished and optimized to handle complex architectures while attempting to intelligently show and hide details.
+- **Git diff visualization**: Seamlessly sync and visualize the changes you or your agent are making live in diagram form. Inspect the dependencies and intervene when necessary.
 - **Bi-directional Sync**: Seamlessly sync changes between your local YAML files, the self-hosted web UI, and the cloud version at tlDiagram.com.
 - **Standalone Distribution**: A single, dependency-free binary containing both the server and the web application.
 - **CLI built that speaks agent**: Use the [agent skill](./skills/create-diagram/SKILL.md) and teach your agent how to create a diagram of your codebase with the exact detail level you need. You can prompt your agent to add/remove details as needed. 
@@ -29,20 +30,6 @@ Here are some examples that were generated using the agent skill.
 
 ---
 
-## Table of Contents
-
-1. [Quick Start](#quick-start)
-2. [Deployment & Self-Hosting](#deployment--self-hosting)
-3. [The tlDiagram Workflow](#the-tldiagram-workflow)
-4. [Tech Stack](#tech-stack)
-5. [Development Setup](#development-setup)
-6. [Commands Reference](#commands-reference)
-7. [Workspace Structure](#workspace-structure)
-8. [Environment Variables](#environment-variables)
-9. [Troubleshooting](#troubleshooting)
-
----
-
 ## Quick Start
 ### Single line install and start
 ```bash
@@ -86,6 +73,9 @@ Run `tld serve` in any directory to start a local instance that uses your curren
 1. Provide a persistent volume for the `.tld/` directory (where YAMLs and the SQLite cache are stored).
 2. Set `TLD_ADDR=0.0.0.0` and `PORT=8060`.
 
+### Configuration
+Various configuration options are available in `~/.config/tldiagram/tld.yaml`
+
 ---
 
 ## The tlDiagram Workflow
@@ -98,8 +88,6 @@ Run `tld serve` in any directory to start a local instance that uses your curren
 
 ---
 
-## Tech Stack
-
 - **Backend**: Go 1.26+ 
   - *CLI*: Cobra
   - *API*: Connect RPC (gRPC compatible)
@@ -178,7 +166,7 @@ Flags:
       --format string      output format: text or json (default "text")
   -h, --help               help for tld
   -v, --version            version for tld
-  -w, --workspace string   workspace directory (default "tld")
+  -w, --workspace string   workspace directory (prefers .tld, then tld; empty when neither exists)
 
 Use "tld [command] --help" for more information about a command
 

cmd/add/add.go

@@ -5,6 +5,7 @@ import (
 
 	"github.com/mertcikla/tld/internal/cmdutil"
 	"github.com/mertcikla/tld/internal/completion"
+	"github.com/mertcikla/tld/internal/term"
 	"github.com/mertcikla/tld/internal/workspace"
 	"github.com/spf13/cobra"
 )
@@ -71,8 +72,8 @@ func NewAddCmd(wdir, format *string, compact *bool) *cobra.Command {
 			if cmdutil.WantsJSON(*format) {
 				return cmdutil.WriteMutation(cmd.OutOrStdout(), *compact, "add", "add", r)
 			}
-			_, _ = fmt.Fprintf(cmd.OutOrStdout(), "Updated elements.yaml (upserted %s)\n", r)
-			_, _ = fmt.Fprintln(cmd.OutOrStdout(), "Change recorded locally in elements.yaml. Run 'tld apply' to push to cloud.")
+			term.Successf(cmd.OutOrStdout(), "Added element %s to elements.yaml", r)
+			term.Hint(cmd.OutOrStdout(), "Run 'tld apply' to push to cloud.")
 			return nil
 		},
 	}