version: "3" vars: BIN_DIR: "bin" tasks: default: desc: List available tasks cmds: - task --list fmt: desc: Format and fix Go source (gofumpt, go fix) cmds: - gofumpt -w . - go fix ./... proto:install: desc: Install the pinned Buf and protobuf Go generators cmds: - bash tools/proto.sh install proto:generate: desc: Generate and format committed grpc-go service contracts cmds: - bash tools/proto.sh generate proto:lint: desc: Lint protobuf contracts and check compatibility with main cmds: - bash tools/proto.sh lint proto:check: desc: Regenerate contracts and reject uncommitted generated differences cmds: - bash tools/proto.sh check vet: desc: Run go vet cmds: - go vet ./... lint: desc: Run golangci-lint cmds: - golangci-lint run ./... lint:playbooks: desc: "Lint playbook binding dirs for collisions (standalone tool, cmd/archie-playbooks)" summary: | Runs the standalone playbook linter (archie-playbooks lint) against ./playbooks by default. It validates playbook YAML binding files against the same loaders the daemon uses at startup, so a pre-merge check can never disagree with runtime validation. Exit non-zero on any collision / malformed file / invalid binding. Lint a different set of directories directly: go run ./cmd/archie-playbooks lint -dir ./a -dir ./b cmds: - go run ./cmd/archie-playbooks lint -dir ./playbooks vuln: desc: "Scan for known stdlib/dependency CVEs (govulncheck). Not part of task check: it needs network access to the vuln DB and is not build/test-blocking; run it explicitly or in CI." cmds: - govulncheck ./... ui:deps: desc: Install the dashboard's node dependencies (ui/node_modules is gitignored) internal: true dir: ui cmds: - npm install --no-audit --no-fund ui: desc: Build the dashboard into ui/dist (committed; the Go build embeds it) dir: ui deps: [ui:deps] cmds: - npm run build test:ui: desc: Run the dashboard's node tests (DOM-building primitives) dir: ui # Without this, a fresh clone fails the gate on a missing jsdom rather # than a real test failure: ui/node_modules is gitignored and nothing # else in `task check` installs it. deps: [ui:deps] cmds: - npm test dev: desc: "Develop: archied live-reload + archie-gateway + archie-state-store + Vite HMR together. Open http://localhost:5173" summary: | Runs the dev loop in one terminal: * air rebuilds and restarts archied on Go changes * archie-gateway serves ChatContract on 127.0.0.1:8585 (archied dials it for chat; it does not embed a gateway) * archie-state-store owns archie.db on 127.0.0.1:9090, loopback, no token (deployments/dev.toml); both archied and archie-gateway dial it -- neither owns the DB in-process (docs/prds/state-store-contract.md ยง12 step 7) * vite serves the dashboard with hot reload on :5173, proxying /api and /events through to archied on :8484 Open http://localhost:5173 -- not :8484. The Vite server is the one with hot reload; :8484 serves the last built dist/ and will look stale. Ctrl-C stops all four. deps: [dev:daemon, dev:gateway, dev:state-store, dev:ui] dev:daemon: desc: archied only, live-reloading via air (prefer `task dev`) cmds: - air -build.args_bin="-config-overlay,deployments/dev.toml" dev:state-store: desc: archie-state-store only, no live-reload (prefer `task dev`) cmds: - go run ./cmd/archie-state-store -config-overlay deployments/dev.toml dev:gateway: desc: archie-gateway only, no live-reload (prefer `task dev`) cmds: - go run ./cmd/archie-gateway dev:ui: desc: Vite dev server only, expects archied already running (prefer `task dev`) dir: ui cmds: - npm install --no-audit --no-fund - npm run dev dev:mobile: desc: Serve the dashboard on your LAN (token-protected) for phone viewing summary: | Starts archied with the [web] bind on 0.0.0.0 so the dashboard is reachable from your phone, printing the URL (LAN IP + token) and a QR code to scan. Stop `task dev` first: both use port 8484, and two daemons sharing the bot identity would double-poll the forge. Frontend served is the embedded dist, so run `task ui` if you changed the frontend. deps: - ui cmds: - cmd: | IP=$(hostname -I | awk '{print $1}') TOKEN=$(cat "${XDG_DATA_HOME:-$HOME/.local/share}/archie/web-token" 2>/dev/null) URL="http://$IP:8484/?t=$TOKEN" echo "Phone URL: $URL" echo "$URL" | qrencode -t ANSIUTF8 - go run ./cmd/archied -config-overlay ~/.config/archie/mobile.toml build: desc: Build archie services and agent binaries # Version stamping used to live only in Dockerfile.archied, so any build # from source -- including a host deployment -- reported "dev" for # both components and /version was useless there. Derive the same # -X values from the release tags so a source build is stamped too. # git describe (without --abbrev=0) yields 1.7.0-2-gbb54786 when HEAD is # past the tag, which is the honest answer for a mid-cycle build. vars: GATEWAY_VERSION: sh: git describe --tags --match 'archied/v*' 2>/dev/null | sed 's|^archied/v||' || echo dev RUNTIME_VERSION: sh: git describe --tags --match 'archie/v*' 2>/dev/null | sed 's|^archie/v||' || echo dev sources: - "**/*.go" - go.mod - go.sum generates: - "{{.BIN_DIR}}/archied" - "{{.BIN_DIR}}/archie-gateway" - "{{.BIN_DIR}}/archie-state-store" - "{{.BIN_DIR}}/archie-ui" - "{{.BIN_DIR}}/archie-agent" cmds: - go build -ldflags "-X github.com/samcharles93/archie-core/internal/app/archied.gatewayVersion={{.GATEWAY_VERSION}} -X github.com/samcharles93/archie-core/internal/app/archied.runtimeVersion={{.RUNTIME_VERSION}} -X github.com/samcharles93/archie-core/internal/installtype.buildType=binary" -o {{.BIN_DIR}}/archied ./cmd/archied - go build -ldflags "-X github.com/samcharles93/archie-core/internal/app/archied.gatewayVersion={{.GATEWAY_VERSION}} -X github.com/samcharles93/archie-core/internal/installtype.buildType=binary" -o {{.BIN_DIR}}/archie-gateway ./cmd/archie-gateway - go build -o {{.BIN_DIR}}/archie-state-store ./cmd/archie-state-store - go build -o {{.BIN_DIR}}/archie-ui ./cmd/archie-ui - go build -ldflags "-X github.com/samcharles93/archie-core/internal/app/agentworker.version={{.RUNTIME_VERSION}} -X github.com/samcharles93/archie-core/internal/installtype.buildType=binary" -o {{.BIN_DIR}}/archie-agent ./cmd/archie-agent test: desc: Run the Go test suite cmds: - go test ./... -count=1 check: desc: "Full quality gate: fmt, go fix, proto, vet, lint, build, test, ui tests" cmds: - task: fmt - go fix ./... - task: proto:lint - task: proto:check - task: vet - task: lint - task: build - task: test # The dashboard's suite runs here too. Left out of the gate it rots # silently: nothing else executes it, so a broken DOM primitive ships. - task: test:ui release:preview: desc: "Show the release notes that would be generated (VERSION=1.2.0, or GATEWAY=/RUNTIME= to version the two components separately)" cmds: - tools/release.sh --gateway {{.GATEWAY | default .VERSION}} --runtime {{.RUNTIME | default .VERSION}} --dry-run requires: vars: [VERSION] release:prepare: desc: "Write the generated notes into the changelogs, uncommitted, for editing (VERSION=1.2.0)" cmds: - tools/release.sh --gateway {{.GATEWAY | default .VERSION}} --runtime {{.RUNTIME | default .VERSION}} --prepare requires: vars: [VERSION] release: desc: "Freeze the edited changelogs into a release commit and tags (VERSION=1.2.0). Run release:prepare first." cmds: - tools/release.sh --gateway {{.GATEWAY | default .VERSION}} --runtime {{.RUNTIME | default .VERSION}} --tag requires: vars: [VERSION] clean: desc: Remove build artifacts cmds: - rm -rf {{.BIN_DIR}} docker-build: desc: Build the archie-agent sandbox image cmds: - docker compose build agent docker-up: desc: Start the optional external NATS service via docker compose cmds: - docker compose up -d nats docker-down: desc: Stop the docker compose stack cmds: - docker compose down docker-logs: desc: Follow the NATS container logs cmds: - docker compose logs -f nats