Skip to content

Fix CI release notes: fetch full git history to detect previous tags#6

Merged
Karib0u merged 3 commits into
mainfrom
feature/modular-installation-system
Nov 13, 2025
Merged

Fix CI release notes: fetch full git history to detect previous tags#6
Karib0u merged 3 commits into
mainfrom
feature/modular-installation-system

Conversation

@Karib0u
Copy link
Copy Markdown
Owner

@Karib0u Karib0u commented Nov 13, 2025

Summary

Fixes a bug in the CI workflow where release notes always showed "Initial Release" instead of properly detecting previous tags and listing changes.

Problem

The build-release job was using a shallow clone (default behavior of actions/checkout@v4), which doesn't fetch tag history. This caused git describe to fail when looking for the previous tag, resulting in all releases showing:

## Initial Release
First release of kernagent

Instead of the correct:

## Changes since v1.0.1
- Commit message 1
- Commit message 2
...

Solution

Added fetch-depth: 0 to the checkout step in the build-release job to fetch full git history including all tags.

Changes

  • .github/workflows/ci.yml: Added fetch-depth: 0 to checkout action in build-release job

Testing

This fix will be verified on the next tag release (v1.0.3 or later). The CI will now be able to:

  1. Detect the previous tag correctly
  2. Generate proper "Changes since vX.Y.Z" release notes
  3. List actual commits between releases

Impact

  • ✅ Future releases will have accurate auto-generated release notes
  • ℹ️ No impact on existing releases (v1.0.2 and earlier)
  • ℹ️ No changes to Docker build process
  • ℹ️ No changes to test/lint workflows

Karib0u and others added 3 commits November 13, 2025 20:16
…documentation overhaul

This commit introduces significant improvements to project structure, installation
workflow, and documentation quality:

## New Features

- **License Compliance**: Added NOTICE file with Apache 2.0 headers and proper
  third-party attributions (Ghidra, capa)

- **Modular Tooling**: Created standalone utilities for better user experience:
  * kernagent-config: Interactive configuration editor
  * kernagent-update: Version management with tag pinning support
  * kernagent-uninstall: Clean removal of all installed components

## Refactoring

- **Installation System**: Transformed monolithic install.sh into a bootstrapper
  that delegates to modular scripts in scripts/ directory
  * Core logic moved to scripts/install.sh (234 lines)
  * Main wrapper extracted to scripts/kernagent (180 lines)
  * 538 lines removed from root install.sh

- **Documentation**: Complete README.md restructure for clarity and usability
  * Added 3 clear installation paths (wrapper, Docker Compose, raw Docker)
  * Better emphasis on offline-first and headless design
  * Streamlined quick-start with verification steps
  * Improved model configuration guidance
  * Net reduction in length while adding more actionable content

- **Docker Setup**: Simplified docker-compose.yml configuration
  * Removed complex anchor patterns
  * Cleaner service definitions

## Statistics

Files changed: 9 files
Lines added: 1,515
Lines removed: 952

New files: NOTICE, scripts/{install.sh,kernagent,kernagent-config,
           kernagent-update,kernagent-uninstall}

🤖 Generated with [Claude Code](https://claude.com/claude-code)

Co-Authored-By: Claude <noreply@anthropic.com>
The build-release job was doing a shallow clone, preventing git describe
from finding previous tags. This caused all releases to show 'Initial Release'
instead of proper 'Changes since vX.Y.Z' notes.

Added fetch-depth: 0 to checkout step to fetch all history and tags.

🤖 Generated with [Claude Code](https://claude.com/claude-code)

Co-Authored-By: Claude <noreply@anthropic.com>
@Karib0u Karib0u merged commit 038040f into main Nov 13, 2025
2 checks passed
@Karib0u Karib0u deleted the feature/modular-installation-system branch November 13, 2025 20:05
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant