test: add smoke test, CI workflow, and agent guidance #1

Merged

w33ble merged 5 commits from feat/initial-implementation into main

2026-09-25 19:39:50 -06:00

hijynx commented

2026-09-25 19:23:56 -06:00

Collaborator

Summary

End-to-end smoke test (proxy_test.go): builds the binary, runs it against a stub streamable-HTTP MCP server, and asserts the initialize round-trip, header injection, and a clean exit on stdin EOF; plus a mise run test task
Forgejo CI workflow (.forgejo/workflows/ci.yaml): build, vet, test, and lint on push/PR, with the golangci-lint binary cached by version (picoclaw pattern)
AGENTS.md: go-sdk gotchas (EncodeMessage emits no trailing newline; streamable transport keeps the GET SSE stream open after stdin EOF), golangci-lint v2 config-schema note, and the feature-branch/PR convention (main is protected)

Why

Session retro found the repo had no tests — a phantom fix and a stdio line-framing bug survived several debug cycles before od -c caught it. The smoke test pins those behaviors; CI enforces the checks AGENTS.md already mandates; the docs capture the gotchas that cost the most debugging time.

## Summary - End-to-end smoke test (proxy_test.go): builds the binary, runs it against a stub streamable-HTTP MCP server, and asserts the initialize round-trip, header injection, and a clean exit on stdin EOF; plus a `mise run test` task - Forgejo CI workflow (.forgejo/workflows/ci.yaml): build, vet, test, and lint on push/PR, with the golangci-lint binary cached by version (picoclaw pattern) - AGENTS.md: go-sdk gotchas (EncodeMessage emits no trailing newline; streamable transport keeps the GET SSE stream open after stdin EOF), golangci-lint v2 config-schema note, and the feature-branch/PR convention (main is protected) ## Why Session retro found the repo had no tests — a phantom fix and a stdio line-framing bug survived several debug cycles before `od -c` caught it. The smoke test pins those behaviors; CI enforces the checks AGENTS.md already mandates; the docs capture the gotchas that cost the most debugging time.

hijynx added 4 commits

2026-09-25 19:23:56 -06:00

test: add end-to-end smoke test 1793d29ffc

Builds the binary, runs it against a stub streamable-HTTP MCP server,
and asserts the initialize round-trip, header injection, and a clean
exit on stdin EOF. Guardrail for the stdio line-framing and EOF-shutdown
behaviors the SDK hides.

docs: record SDK gotchas and golangci-lint v2 config note 7f62f5a4a5

ci: add Forgejo CI workflow c6b9d44d7f

Runs build, vet, test, and lint on push and PRs. Caches the compiled
golangci-lint binary keyed by version (picoclaw pattern) to avoid a
from-source rebuild on every run.

docs: work on feature branches, main is protected

CI / Build, vet, test, lint (pull_request) Successful in 7m13s

Details

08ce348e9c

hijynx added 1 commit

2026-09-25 19:36:33 -06:00

ci: use golangci-lint-action for linting

CI / Build, vet, test, lint (pull_request) Successful in 1m30s

Details

CI / Build, vet, test, lint (push) Successful in 2m31s

Details

release / release (push) Successful in 5m7s

Details

eb68e69fd8

Replaces the manual binary cache/install steps with
golangci/golangci-lint-action@v9, which handles binary download and
analysis-cache internally (build/module caches stay with setup-go).
only-new-issues is left off: it calls GitHub-only PR APIs.