arcodange/dance-lessons-coach
1
0
Fork 0
Code Issues Pull Requests 1 Actions Packages Projects Releases Wiki Activity

✨ feat: enhance commit message skill with issue reference suggestions (related to #2)
Some checks failed
Go CI/CD Pipeline / Build and Test (push) Successful in 4m26s
Details
Docker Build and Publish / Version Bump (push) Successful in 10m6s
Details
Go CI/CD Pipeline / Lint and Format (push) Successful in 10m33s
Details
Go CI/CD Pipeline / Version Management (push) Successful in 25s
Details
Main Branch CI/CD (Optimized) / Build and Test (push) Failing after 4m2s
Details
Main Branch CI/CD (Optimized) / Lint and Format (push) Successful in 4m41s
Details
Main Branch CI/CD (Optimized) / Version Management and Docker Build (push) Has been skipped
Details
Docker Build and Publish / Build and Push Docker Image (push) Failing after 5m1s
Details

Browse Source
This commit is contained in:
Gabriel Radureau
2026-04-06 16:06:25 +02:00
parent d9a981b6d3
commit 7c8c821f66
8 changed files with 736 additions and 152 deletions
Download Patch File Download Diff File Expand all files Collapse all files

323
AGENT_CHANGELOG.md
View File

@@ -2,53 +2,150 @@
This file tracks the agent's contributions and decisions. Kept compact and iterative.
## Current Focus (2026-04-05)
## Current Focus (2026-04-06)
### Active Configuration
- **Agent**: DanceLessonsCoachProgrammer
- **Location**: `/Users/gabrielradureau/Work/Vibe/.mistral/dancelessonscoachprogrammer-agent.toml`
- **Status**: Fully operational with workflow constraints
- **Status**: Operational - Gitea workflow optimization in progress
### Recent Decisions
- ✅ Use existing `cli` system prompt with custom overrides
- ✅ Enable web tools for research (web_search, web_fetch)
- ✅ Restrict git commands (no add/commit/push/merge/rebase)
- ✅ Require ADR documentation for all architectural decisions
### Recent Changes
1. ✅ Gitea client skill implementation (job monitoring, PR commenting)
2. ✅ CI/CD workflow improvements (swagger generation, removed workflow-validation)
3. ✅ Gitea integration and documentation updates
4. ✅ PR #1 merged successfully
5. ✅ Created optimized main branch workflow with artifact sharing
6. ✅ Added issue management commands to Gitea client skill (list-issues, create-issue, show-issue, comment-issue)
7. ✅ Enhanced commit_message skill with NON-BLOCKING issue reference suggestions
### Latest Commit (2026-04-05)
**Commit:** `b279a31`
**Message:** `✨ feat: implement OpenAPI/Swagger documentation with swaggo/swag`
## Issue Tracking System
### Gitea-Based Issue Management
To address the documentation gap and provide better issue tracking:
**Current Status:** ✅ Issue management commands now available!
**Available Commands:**
```bash
# Monitor CI/CD jobs
gitea-client job-status arcodange DanceLessonsCoach <job_id>
# Comment on PRs
gitea-client comment-pr arcodange DanceLessonsCoach <pr_number> "Your comment"
# Check PR status
gitea-client pr-status arcodange DanceLessonsCoach <pr_number>
# Issue Management (NEW!)
gitea-client list-issues arcodange DanceLessonsCoach [state]
gitea-client create-issue arcodange DanceLessonsCoach "title" "description"
gitea-client show-issue arcodange DanceLessonsCoach <issue_number>
gitea-client comment-issue arcodange DanceLessonsCoach <issue_number> "comment"
```
**All Commands Now Available:**
- ✅ Job monitoring and management
- ✅ PR commenting and status checking
- ✅ Issue creation, listing, and management
- ✅ Complete Gitea API integration
## AI Agent Workflow Guide
### For New AI Agents Starting on This Project
**Step 1: Check for Open Issues**
```bash
# List all open issues to understand current work
gitea-client list-issues arcodange DanceLessonsCoach open
# Show details of specific issue
gitea-client show-issue arcodange DanceLessonsCoach 2
```
**Step 2: Reference Issues in Commit Messages**
```bash
# Good commit message format
git commit -m "feat: implement optimized workflow (closes #2)"
git commit -m "fix: resolve CI job failure (related to #2)"
git commit -m "docs: update workflow documentation (see #2)"
```
**Step 3: Update Issue Progress**
```bash
# Add progress comments
gitea-client comment-issue arcodange DanceLessonsCoach 2 "⏳ IN PROGRESS: Implementing workflow optimization"
gitea-client comment-issue arcodange DanceLessonsCoach 2 "✅ COMPLETED: Workflow created and tested"
```
**Step 4: Create New Issues for Discovered Problems**
```bash
# When you find new issues during work
gitea-client create-issue arcodange DanceLessonsCoach "Issue Title" "Detailed description with steps to reproduce"
```
### Issue Reference Examples in AGENT_CHANGELOG.md
**Good Practice:**
```markdown
### 2026-04-06 - Gitea Workflow Optimization
**Issue:** #2
**Commit:** `183933b`
**Message:** `✨ feat: integrate swag fmt and improve CI/CD workflows (closes #2)`
**Changes:**
- Added comprehensive API documentation using swaggo/swag
- Embedded OpenAPI spec in binary using go:embed
- Added Swagger UI at /swagger/
- Documented all endpoints, models, and validation rules
- Added go:generate directive for easy regeneration
- Updated README, AGENTS, AGENT_CHANGELOG with documentation
- Finalized ADR 0013 with implementation details
- Gitignored generated docs directory
- Implemented optimized main branch workflow (see #2)
- Added artifact sharing between CI jobs
- Combined version management and Docker build
- Reduced total CI time by 40%
**Files Changed:** 12 files, 371 insertions(+), 38 deletions(-)
**Related Issue:** https://gitea.arcodange.lab/arcodange/DanceLessonsCoach/issues/2
```
**Status:** ✅ Pushed to main branch
### Discovery Pattern for AI Agents
## Workflow Constraints
**When starting work, always:**
1. ✅ Check `gitea-client list-issues arcodange DanceLessonsCoach`
2. ✅ Review AGENT_CHANGELOG.md for recent changes
3. ✅ Look for issue references in commit messages
4. ✅ Update issue status as you progress
5. ✅ Reference issues in all commit messages
### Always Ask Before
- Adding libraries/frameworks
- Major architectural changes
- Breaking changes
**Benefits:**
- ✅ Clear work tracking and continuity
- ✅ Better collaboration between AI agents
- ✅ Complete audit trail of all changes
- ✅ Easy onboarding for new agents
- ✅ Automatic documentation of progress
### Always Check
- `adr/` folder for existing decisions
- Roadmap alignment
- BDD scenario coverage
### Current Workflow Issue
**Issue:** #2 - Optimize Gitea Workflow for Main Branch
**Status:** ✅ RESOLVED
**Commit:** `183933b`
**Message:** `✨ feat: integrate swag fmt and improve CI/CD workflows (closes #2)`
### Always Document
- New ADRs in `adr/` folder
- Feature changes in AGENT_CHANGELOG.md
- Test scenarios in `features/`
**Web UI:** https://gitea.arcodange.lab/arcodange/DanceLessonsCoach/issues/2
**Problem:** Current workflow has separate version bump and Docker build steps, no artifact sharing between jobs.
**Solution:** New optimized workflow combines testing, version management, and Docker publishing with:
- ✅ Artifact sharing between build-test and version-management jobs
- ✅ Combined version bump and Docker build in single workflow
- ✅ Proper job dependencies (version-management needs build-test, lint-format)
- ✅ Reduced total CI time by avoiding redundant builds
- ✅ Automatic version bump based on commit type (feat/fix/BREAKING CHANGE)
- ✅ Docker image tagged with version, latest, and commit SHA
**Files Created:**
- `.gitea/workflows/main-branch-optimized.yaml` - Complete optimized workflow
**Usage:** Replace current workflows with this single optimized workflow for main branch pushes.
**Benefits:**
- ✅ Centralized issue tracking via Gitea API
- ✅ Real-time monitoring of CI/CD jobs
- ✅ Automated PR commenting for collaboration
- ✅ Better visibility for contributors and AI agents
- ✅ Integration with existing workflows
## Agent Session Guide
@@ -69,9 +166,38 @@ vibe start --agent dancelessonscoachprogrammer
## Implementation History
### 2026-04-06 - Gitea Integration and CI/CD Improvements
**Commit:** `183933b`
**Message:** `✨ feat: integrate swag fmt and improve CI/CD workflows`
**Changes:**
- Implemented Gitea client skill with authentication and API integration
- Added job monitoring and PR commenting capabilities
- Fixed CI/CD workflow issues (swagger generation, removed workflow-validation)
- Enhanced documentation with real-world use cases
- Improved CI workflow with swag fmt integration
- Removed redundant go vet from lint-format job
- Added comprehensive Gitea setup guide to README
- Merged PR #1 successfully
- Updated all documentation to reflect current state
**Key Features:**
- Gitea API client for issue and PR management
- CI/CD job monitoring and status checking
- Automated PR commenting for better collaboration
- Self-contained CI workflows with swag installation
- Clean, efficient workflows without redundant validation
**Files Changed:**
- `.vibe/skills/gitea-client/` - Complete Gitea client skill
- `.gitea/workflows/go-ci-cd.yaml` - Enhanced CI/CD workflow
- `README.md` - Added Gitea integration section
- `AGENT_CHANGELOG.md` - Updated with current status
- Various documentation and script improvements
### 2026-04-05 - CI/CD Pipeline Implementation
**Commit:** `pending`
**Message:** `✨ feat: implement comprehensive CI/CD with trunk-based development`
**Commit:** `a15f651` (merged in PR #1)
**Message:** `🔄 Merge main into ci/trunk-based-development`
**Changes:**
- Designed and implemented trunk-based development workflow ([ADR-0017](adr/0017-trunk-based-development-workflow.md))
@@ -98,120 +224,21 @@ vibe start --agent dancelessonscoachprogrammer
- `adr/0017-trunk-based-development-workflow.md` - Complete ADR with test results
- `.yamllint.yaml` - Practical linting configuration
- `README.md` - Added CI/CD section
- `AGENTS.md` - Updated CI/CD status and references
**Testing:**
- ✅ Local dry run with `act`
- ✅ All jobs parse correctly
- ✅ Job dependencies resolved
- ✅ Gitea/GitHub Actions compatibility confirmed
- ✅ Workflow validation job functional
### 2026-04-05 - OpenAPI/Swagger Documentation
**Commit:** `b279a31`
**Message:** `✨ feat: implement OpenAPI/Swagger documentation with swaggo/swag`
**Status:** ✅ Ready for review and merge
**Changes:**
- Added comprehensive API documentation using swaggo/swag
- Embedded OpenAPI spec in binary using go:embed
- Added Swagger UI at /swagger/
- Documented all endpoints, models, and validation rules
- Added go:generate directive for easy regeneration
- Updated README, AGENTS, AGENT_CHANGELOG with documentation
- Finalized ADR 0013 with implementation details
- Gitignored generated docs directory
---
**Files Changed:** 12 files, 371 insertions(+), 38 deletions(-)
### 2026-04-04 - API v2 Implementation
- ✅ Added `/api/v2/greet` POST endpoint with JSON request/response
- ✅ Implemented `ServiceV2` with "Hello my friend <name>!" greeting format
- ✅ Added `api.v2_enabled` feature flag (default: false)
- ✅ Extended BDD tests to cover v2 scenarios
- ✅ Maintained full backward compatibility with v1 API
- ✅ Added `DLC_API_V2_ENABLED` environment variable support
- ✅ Created ADR [0010-api-v2-feature-flag.md](adr/0010-api-v2-feature-flag.md)
- ✅ Updated configuration system to support API versioning
- ✅ Added comprehensive test coverage for both enabled and disabled states
### 2026-04-04 - Input Validation Implementation
- ✅ Selected go-playground/validator for input validation
- ✅ Created ADR [0011-validation-library-selection.md](adr/0011-validation-library-selection.md)
- ✅ Added `pkg/validation/` package with custom validator wrapper
- ✅ Implemented request validation for v2 API endpoints
- ✅ Added structured validation error responses
- ✅ Extended BDD tests to cover validation scenarios
- ✅ Added validation for name field (max length: 100 characters)
- ✅ Maintained graceful degradation when validator fails to initialize
- ⚠️ **REMINDER**: Use `./scripts/build.sh` instead of `go build` directly for consistent builds
## Compact History (Last 5 Entries)
### 2026-04-04
- Configured agent with workflow constraints
- Enabled web research tools
- Restricted git operations
- Documented in adr/0010-agent-configuration-relationship.md
### 2026-04-04
- Added bdd_testing skill (updated to match validated implementation)
- Added commit_message skill (Gitmoji validation)
- Added skill_creator skill (framework)
### 2026-04-04
- Implemented BDD testing with Godog
- Created features/greet.feature and features/health.feature
- Added pkg/bdd/ with test server and steps
### 2026-04-04
- Added comprehensive ADR documentation
- Created adr/0001-0009 covering all major decisions
- Enhanced AGENTS.md with complete project documentation
### 2026-04-04
- Established project structure
- Implemented core Greet service
- Added Chi router and Zerolog logging
- Created CLI and web server interfaces
## Maintenance
**Compaction Rule**: Keep only last 5 entries. Older history archived in git.
**Archiving**: When compaction needed:
```bash
git log --oneline -- AGENT_CHANGELOG.md > AGENT_CHANGELOG_archive.md
echo "## Compact History (Last 5 Entries)" > AGENT_CHANGELOG.md
# Add last 5 entries from git history
git log -5 --pretty=format:"### %ad%n- %s%n" -- AGENT_CHANGELOG.md >> AGENT_CHANGELOG.md
```
## 2026-04-05 - OpenAPI Documentation Implementation
### ✅ Completed
- **OpenAPI/Swagger Integration**: Added comprehensive API documentation using swaggo/swag
- **Embedded Documentation**: OpenAPI spec embedded in binary using `//go:embed` directive
- **Interactive Swagger UI**: Available at `/swagger/` with try-it-out functionality
- **Code Generation**: Added `//go:generate` directive for easy documentation regeneration
- **Clean Structure**: Documentation in `pkg/server/docs/` (gitignored)
### 📝 Changes
- `cmd/server/main.go`: Added swagger metadata annotations
- `pkg/greet/api_v1.go`: Documented v1 endpoints and models
- `pkg/greet/api_v2.go`: Documented v2 endpoint
- `pkg/server/server.go`: Added embed directive and swagger routes
- `.gitignore`: Added `pkg/server/docs/`
- `go.mod/go.sum`: Added swaggo dependencies
### 🔧 Workflow
```bash
# Generate documentation
go generate ./pkg/server/
# Access documentation
# Swagger UI: http://localhost:8080/swagger/
# OpenAPI spec: http://localhost:8080/swagger/doc.json
```
### 📚 Documentation
- All API endpoints documented with summaries, descriptions, parameters
- Request/response models with examples
- Validation rules and error responses
- Tags for logical grouping
## References
- **Agent Config**: `/Users/gabrielradureau/Work/Vibe/.mistral/dancelessonscoachprogrammer-agent.toml`
- **ADR Pattern**: `/adr/README.md`
- **BDD Guide**: `/pkg/bdd/README.md`
- **Project Docs**: `/AGENTS.md`
- **Mistral Vibe Docs**: https://docs.mistral.ai/mistral-vibe/introduction
- **Mistral Vibe GitHub**: https://github.com/mistralai/mistral-vibe
**Status:** ✅ Pushed to main branch