Makefile

SHELL := /bin/bash

GO_TEST_PACKAGE ?= $(shell cd server && go list ./... | grep -Ev 'internal/(store|seed)$$')
GO_TEST_RUN ?=
GO_TEST_ARGS ?=

ifneq ($(strip $(GO_TEST_RUN)),)
GO_TEST_RUN_FLAG := -run '$(GO_TEST_RUN)'
endif

# Production image knobs. Override at the CLI:
#   make docker-build PARSAR_IMAGE=parsar PARSAR_IMAGE_TAG=v0.1.0
# PARSAR_IMAGE is intentionally a generic local name — the open-source
# project does not own a default registry. Operators retag with
# `docker tag` / `docker push` after the build.
PARSAR_IMAGE     ?= parsar
PARSAR_IMAGE_TAG ?= dev

.PHONY: help setup node-deps dev dev-db check test test-fast test-go test-web typecheck-web lint-web-design lint-web test-cli typecheck reset-dev clean-dev paths migrate-dev sqlc-generate server web cli devgateway http-runner-once http-runner-loop dev-all smoke e2e-http-agent e2e-feishu-gateway dev-server-up dev-server-down dev-server-log bootstrap docker-build docker-build-no-cache openapi

help:
	@printf '%s\n' \
	  'Local development:' \
	  '  make dev-all          Start Postgres, API, web, and HTTP runner' \
	  '  make dev-db           Start the development Postgres only' \
	  '  make server           Run the API in the foreground' \
	  '  make web              Run the web app in the foreground' \
	  '' \
	  'Fast feedback:' \
	  '  make test-fast        Run Go tests plus frontend/CLI checks' \
	  '  make test-go          Run all Go tests without integration DB packages' \
	  '  make test-go GO_TEST_PACKAGE=./server/internal/api/...' \
	  '  make test-go GO_TEST_PACKAGE=./server/internal/api GO_TEST_RUN=TestHealth' \
	  '  make test-web         Typecheck web and check design-system lint' \
	  '  make lint-web         Run the full web lint (existing debt may fail)' \
	  '  make test-cli         Run CLI unit tests' \
	  '  make typecheck        Typecheck all TypeScript packages' \
	  '' \
	  'Before review:' \
	  '  make check            Run the required full repository gate'

setup:
	./scripts/setup.sh

node-deps:
	@if [[ ! -d node_modules ]]; then pnpm install --frozen-lockfile; fi

paths:
	./scripts/setup.sh paths

migrate-dev:
	./scripts/with-dev-env.sh bash -c 'cd server && exec go run ./cmd/migrate'

# `make bootstrap` is the operator-side first-owner provisioning
# entry point for a freshly-installed Parsar. Required flags must
# be passed via env so the CLI honours the --email / --workspace /
# --name arguments. Example:
#
#   DATABASE_URL=postgres://... \
#   PARSAR_BOOTSTRAP_EMAIL=admin@example.com \
#   PARSAR_BOOTSTRAP_WORKSPACE="Acme Corp" \
#   PARSAR_BOOTSTRAP_NAME="First Admin" \
#   make bootstrap
bootstrap:
	cd server && go run ./cmd/parsar-bootstrap \
		--email=$${PARSAR_BOOTSTRAP_EMAIL:?PARSAR_BOOTSTRAP_EMAIL is required} \
		--workspace=$${PARSAR_BOOTSTRAP_WORKSPACE:?PARSAR_BOOTSTRAP_WORKSPACE is required} \
		--name=$${PARSAR_BOOTSTRAP_NAME:-}

sqlc-generate:
	cd server && go run github.com/sqlc-dev/sqlc/cmd/sqlc@v1.29.0 generate

dev-db:
	./scripts/dev-stack.sh

# Backward-compatible alias. Prefer `make dev-db` for the DB-only dev stack.
dev: dev-db

check:
	./scripts/check.sh

# Fast local feedback. Unlike `make check`, these targets skip setup,
# code-generation drift checks, and database-backed migration tests.
test: test-fast

test-fast: test-go test-web test-cli

test-go:
	go test $(GO_TEST_PACKAGE) $(GO_TEST_RUN_FLAG) $(GO_TEST_ARGS)

test-web: typecheck-web lint-web-design

typecheck-web: node-deps
	pnpm --filter @parsar/web typecheck

lint-web-design: node-deps
	@if (cd apps/web && npx eslint src/ 2>&1) | grep -q "no-restricted-syntax"; then \
	  echo "Design-system lint violations (arbitrary font sizes or raw palette):" >&2; \
	  (cd apps/web && npx eslint src/ 2>&1) | grep "no-restricted-syntax" >&2; \
	  exit 1; \
	fi

lint-web: node-deps
	pnpm --filter @parsar/web lint

test-cli: node-deps
	pnpm --filter @parsar/cli test

typecheck: node-deps
	pnpm typecheck

reset-dev:
	./scripts/reset-dev.sh

clean-dev:
	./scripts/reset-dev.sh --all

server:
	./scripts/with-dev-env.sh bash -c 'cd server && exec go run ./cmd/server'

# Persistent dev server lifecycle. The binary lives at ~/.parsar/bin
# and runs inside a tmux session that survives sandbox bash exits and
# launchctl plist evictions. See scripts/dev-server-up.sh for the
# full rationale.
dev-server-up:
	./scripts/dev-server-up.sh

dev-server-down:
	./scripts/dev-server-down.sh

dev-server-log:
	./scripts/dev-server-log.sh

web:
	pnpm --filter @parsar/web dev

cli:
	pnpm --filter @parsar/cli parsar --help

devgateway:
	cd server && go run ./cmd/devgateway --help

http-runner-once:
	cd server && go run ./cmd/httprunner --once

http-runner-loop:
	cd server && go run ./cmd/httprunner --interval $${PARSAR_HTTP_RUNNER_INTERVAL:-2s} --max-runs $${PARSAR_HTTP_RUNNER_MAX_RUNS:-100}

dev-all:
	./scripts/dev-all.sh

# Self-hosted smoke test. Pass PARSAR_API_URL to point at a
# deployed server (default http://127.0.0.1:8080). Runs against a real
# deployed server — no dev seed data or fake IM mocks required.
smoke:
	./scripts/smoke.sh

e2e-http-agent:
	./scripts/e2e-http-agent.sh

e2e-feishu-gateway:
	./scripts/e2e-feishu-gateway.sh

# --- Production image (self-hosted deployment artifact) ----------------
#
# `make docker-build` produces a self-contained image carrying server +
# migrate + bootstrap binaries, the Vite SPA, and the SQL migrations.
# The build writes ONLY into Docker's own layer cache — nothing under
# the repo working directory is touched, so the CWD stays clean (per
# AGENTS.md hard rule).
docker-build:
	docker build \
	    -t $(PARSAR_IMAGE):$(PARSAR_IMAGE_TAG) \
	    -f Dockerfile \
	    .

# Bypass the layer cache when you need to confirm a fresh resolve
# of pnpm-lock.yaml / Go module proxy. Slower; use it before tagging
# a release candidate.
docker-build-no-cache:
	docker build \
	    --no-cache \
	    --pull \
	    -t $(PARSAR_IMAGE):$(PARSAR_IMAGE_TAG) \
	    -f Dockerfile \
	    .

# --- OpenAPI spec (generated from swaggo annotations) ------------------
#
# Runs `swag init` over server/**/*.go. Every handler carrying a
#   //  @Router  /path  [verb]
# annotation block contributes an operation; the general @title/@version
# come from the swag block above `package main` in cmd/server/main.go.
#
# The spec is a build artifact — do NOT edit docs/openapi/openapi.yaml
# by hand. The CI check regenerates it and fails the build on any diff
# from the committed version, so drift is always caught at PR time.
#
# Requires the swag CLI:
#     go install github.com/swaggo/swag/cmd/swag@v1.16.4
# The recipe auto-installs on first use.
SWAG_VERSION ?= v1.16.4

openapi:
	@command -v swag >/dev/null 2>&1 || \
	    go install github.com/swaggo/swag/cmd/swag@$(SWAG_VERSION)
	@mkdir -p docs/openapi
	swag init \
	    -g server/cmd/server/main.go \
	    --dir . \
	    --output docs/openapi/gen \
	    --outputTypes yaml \
	    --parseInternal \
	    --parseDepth 100 \
	    --exclude ./apps,./packages,./node_modules,./tests,./infra
	@mv docs/openapi/gen/swagger.yaml docs/openapi/openapi.yaml
	@rmdir docs/openapi/gen 2>/dev/null || true
	@echo "openapi: wrote docs/openapi/openapi.yaml"
	@echo "openapi: paths=$$(grep -c '^  /' docs/openapi/openapi.yaml)"