v1.0.1: Public documentation and release workflow

Public documentation and release workflow

• Replaced the long README with a 56-line overview and linked setup, security, development, deployment, and operations guides.
• Added guarded annotated-tag/stable-release tooling and documented SemVer publication for every delivered change.
• Updated Go to toolchain 1.27.1, stable Go dependencies, container bases, and GitHub Actions.
• Aligned the service version with v1.0.1 and expanded private environment-file ignores.

Compatibility

No API or database migration changes. Companion skill version 2.1 is unchanged. Back up before upgrades; deploy the CI-published commit-SHA image (source release tags are not container tags).

Verification

Local service check gate, PostgreSQL-backed race/integration tests, 55 hermetic client checks, and 35 live HTTP checks passed. The documented Compose build/start, first submission/list, readiness, and teardown were exercised in isolation. Publication tooling requires successful CI on this exact commit before tagging.

Publication audit

Reachable history was checked for secrets, unintended private details, and AI authorship attribution. No additional sensitive content requiring a rewrite was identified; v1.0.0 remains unchanged. Scanning cannot establish the absence of all secrets, and existing clones/caches cannot be erased by a history rewrite.

agent-feedback v1.0.0

First stable release of agent-feedback: a self-hosted Go/PostgreSQL inbox for AI coding-agent review results and tooling/documentation friction reports.

Included

• JSON REST API for immutable submissions, deduplication, filtering, retrieval, and processed-state tracking.
• Companion Bash skill with credential redaction, local failed-write spooling, recovery, and querying.
• Public setup and API documentation, deployment configuration, backup/recovery guidance, and MIT licensing.
• Linux/amd64 and Linux/arm64 container builds.

Verification

The tagged commit passed CI: formatting/vet/build and generated SQL cleanliness, PostgreSQL race/integration tests, live HTTP contract checks, ShellCheck, hermetic client tests, and multi-architecture container publication.
CI: https://github.com/foae/agent-feedback/actions/runs/34053149811

Deployment

This service is intended for a single trust domain, not an internet-facing multi-tenant service. Read the README security and privacy guidance before collecting real telemetry. The companion skill has its own version number.

Container image for this release: ghcr.io/foae/agent-feedback:e7069aa265122aa4865993ae016760d0874b65b0

Known maintenance item

GitHub Actions reports Node.js 20 deprecation warnings for existing action versions; all jobs passed. Updating those action versions is separate from the readiness fix.