Dev

.github/workflows/ci.yml

@@ -4,7 +4,7 @@ on:
   push:
     branches: [ "main", "dev" ]
   pull_request:
-    branches: [ "main" ]
+    branches: [ "main", "dev" ]
 
 jobs:
   build-and-test:
@@ -21,4 +21,4 @@ jobs:
         run: go build -v ./...
 
       - name: Test
-        run: go test -v ./...
+        run: go test -race -v ./...

.gitignore

@@ -1,2 +1,4 @@
 data/
 awesomeProject
+.gocache
+.vercel

.goreleaser.yaml

@@ -20,9 +20,12 @@ archives:
         format: zip
     name_template: "{{ .ProjectName }}_{{ .Os }}_{{ .Arch }}"
 
+checksum:
+  name_template: "checksums.txt"
+
 changelog:
   sort: asc
   filters:
     exclude:
       - "^docs:"
-      - "^test:"
+      - "^test:"

.vercelignore

@@ -0,0 +1,5 @@
+.git
+.gocache
+.idea
+data
+awesomeProject

README.md

@@ -44,6 +44,33 @@ http://192.168.1.22:8080
 
 Open that address from another device connected to the same Wi-Fi.
 
+## Terminal Download
+
+Install the latest release with either `curl` or `wget`:
+
+```bash
+curl -fsSL https://raw.githubusercontent.com/blackdragoon26/Do-It/main/scripts/install.sh | sh
+```
+
+```bash
+wget -qO- https://raw.githubusercontent.com/blackdragoon26/Do-It/main/scripts/install.sh | sh
+```
+
+The installer downloads the matching GitHub release archive for Linux or macOS on `amd64`/`arm64`, then installs `doit` into `~/.local/bin`. If you cloned the repository or downloaded `scripts/install.sh` locally, override the destination or version when needed:
+
+```bash
+DOIT_INSTALL_DIR=/usr/local/bin DOIT_VERSION=v1.0.0 sh scripts/install.sh
+```
+
+Manual download format:
+
+```text
+https://github.com/blackdragoon26/Do-It/releases/latest/download/Do-It_linux_amd64.tar.gz
+https://github.com/blackdragoon26/Do-It/releases/latest/download/Do-It_linux_arm64.tar.gz
+https://github.com/blackdragoon26/Do-It/releases/latest/download/Do-It_darwin_amd64.tar.gz
+https://github.com/blackdragoon26/Do-It/releases/latest/download/Do-It_darwin_arm64.tar.gz
+```
+
 ## Data Storage
 
 By default, Do-It writes local app data under:

docs/ARCHITECTURE.md

@@ -243,6 +243,7 @@ For the current product, HTTP plus SSE is simpler and easier to debug while lear
 - Uploads are local to one server device.
 - Device presence is approximate because it uses IP plus user agent.
 - No offline edit queue yet.
+- Each mutation currently broadcasts a full task snapshot to every connected browser. That is simple and reliable for a LAN-scale app, but large datasets should move toward diff-based updates or paged sync.
 
 ## Next Architecture Upgrades
 
@@ -252,5 +253,6 @@ Best order:
 2. Pairing code or local auth.
 3. Better backup/export.
 4. Drag-to-reparent graph nodes.
-5. Optional gRPC/Connect-Go API.
-6. mDNS discovery, so devices can open `doit.local`.
+5. Diff-based live sync for large task graphs.
+6. Optional gRPC/Connect-Go API.
+7. mDNS discovery, so devices can open `doit.local`.

go.mod

@@ -1,3 +1,3 @@
-module awesomeProject
+module github.com/blackdragoon26/Do-It
 
 go 1.26

main.go

@@ -1,13 +1,16 @@
 package main
 
 import (
+	"context"
 	"embed"
 	"io/fs"
 	"log"
 	"net/http"
 	"os"
+	"os/signal"
 	"path/filepath"
 	"strings"
+	"syscall"
 	"time"
 )
 
@@ -42,8 +45,30 @@ func main() {
 		log.Printf("LAN device URL: %s", url)
 	}
 
-	if err := server.ListenAndServe(); err != nil && err != http.ErrServerClosed {
-		log.Fatalf("serve: %v", err)
+	serverErr := make(chan error, 1)
+	go func() {
+		serverErr <- server.ListenAndServe()
+	}()
+
+	stop := make(chan os.Signal, 1)
+	signal.Notify(stop, os.Interrupt, syscall.SIGTERM)
+	defer signal.Stop(stop)
+
+	select {
+	case err := <-serverErr:
+		if err != nil && err != http.ErrServerClosed {
+			log.Fatalf("serve: %v", err)
+		}
+	case sig := <-stop:
+		log.Printf("received %s, shutting down", sig)
+		ctx, cancel := context.WithTimeout(context.Background(), 10*time.Second)
+		defer cancel()
+		if err := server.Shutdown(ctx); err != nil {
+			log.Fatalf("shutdown: %v", err)
+		}
+		if err := <-serverErr; err != nil && err != http.ErrServerClosed {
+			log.Fatalf("serve: %v", err)
+		}
 	}
 }
 

scripts/install.sh

@@ -0,0 +1,99 @@
+#!/usr/bin/env sh
+set -eu
+
+repo="blackdragoon26/Do-It"
+install_dir="${DOIT_INSTALL_DIR:-$HOME/.local/bin}"
+version="${DOIT_VERSION:-latest}"
+
+os="$(uname -s | tr '[:upper:]' '[:lower:]')"
+arch="$(uname -m)"
+
+case "$arch" in
+  x86_64|amd64) arch="amd64" ;;
+  arm64|aarch64) arch="arm64" ;;
+  *) echo "unsupported architecture: $arch" >&2; exit 1 ;;
+esac
+
+case "$os" in
+  linux|darwin) archive_ext="tar.gz" ;;
+  *) echo "unsupported OS: $os" >&2; exit 1 ;;
+esac
+
+if [ "$version" = "latest" ]; then
+  base_url="https://github.com/$repo/releases/latest/download"
+else
+  base_url="https://github.com/$repo/releases/download/$version"
+fi
+
+archive="Do-It_${os}_${arch}.${archive_ext}"
+tmp_dir="$(mktemp -d 2>/dev/null || mktemp -d "${TMPDIR:-/tmp}/doit.XXXXXX")"
+trap 'rm -rf "$tmp_dir"' EXIT INT TERM
+
+download() {
+  url="$1"
+  output="$2"
+  if command -v curl >/dev/null 2>&1; then
+    curl -fsSL "$url" -o "$output"
+    return
+  fi
+  if command -v wget >/dev/null 2>&1; then
+    wget -qO "$output" "$url"
+    return
+  fi
+  echo "curl or wget is required" >&2
+  exit 1
+}
+
+download_optional() {
+  url="$1"
+  output="$2"
+  if command -v curl >/dev/null 2>&1; then
+    curl -fsSL "$url" -o "$output" >/dev/null 2>&1 && return 0
+    return 1
+  fi
+  if command -v wget >/dev/null 2>&1; then
+    wget -qO "$output" "$url" >/dev/null 2>&1 && return 0
+    return 1
+  fi
+  echo "curl or wget is required" >&2
+  exit 1
+}
+
+verify_checksum() {
+  archive_path="$1"
+  checksums_path="$2"
+  archive_name="$(basename "$archive_path")"
+  expected="$(awk -v name="$archive_name" '$2 == name { print $1; found = 1 } END { if (!found) exit 1 }' "$checksums_path")" || {
+    echo "checksum for $archive_name not found" >&2
+    exit 1
+  }
+
+  if command -v sha256sum >/dev/null 2>&1; then
+    printf '%s  %s\n' "$expected" "$archive_path" | sha256sum -c -
+    return
+  fi
+  if command -v shasum >/dev/null 2>&1; then
+    actual="$(shasum -a 256 "$archive_path" | awk '{ print $1 }')"
+    if [ "$actual" = "$expected" ]; then
+      return
+    fi
+    echo "$archive_name checksum mismatch" >&2
+    exit 1
+  fi
+  echo "sha256sum or shasum is required to verify downloads" >&2
+  exit 1
+}
+
+download "$base_url/$archive" "$tmp_dir/$archive"
+if download_optional "$base_url/checksums.txt" "$tmp_dir/checksums.txt"; then
+  verify_checksum "$tmp_dir/$archive" "$tmp_dir/checksums.txt"
+else
+  echo "checksums.txt not found for this release; installing without checksum verification" >&2
+fi
+tar -xzf "$tmp_dir/$archive" -C "$tmp_dir"
+
+mkdir -p "$install_dir"
+install "$tmp_dir/doit" "$install_dir/doit"
+
+echo "Installed doit to $install_dir/doit"
+echo "Run: $install_dir/doit"