Release v1.1.0: Major CLI Refactor and Feature Enhancements

.github/workflows/ci.yml

@@ -2,11 +2,27 @@ name: CI
 
 on:
   push:
-    branches: [ main, develop ]
+    branches: [ main, develop ]  # Run on main branches only
     tags:
       - 'v*'  # Trigger on version tags (v1.0.0, v1.2.3, etc.)
   pull_request:
     branches: [ main, develop ]
+  workflow_dispatch:  # Allow manual trigger
+    inputs:
+      test_multiplatform:
+        description: 'Test multi-platform build (amd64 + arm64)'
+        required: false
+        default: false
+        type: boolean
+
+# Cancel previous runs on the same branch/PR to save resources
+concurrency:
+  group: ${{ github.workflow }}-${{ github.ref }}
+  cancel-in-progress: true
+
+# Security: Default to read-only, escalate where needed
+permissions:
+  contents: read
 
 jobs:
   test:
@@ -60,16 +76,21 @@ jobs:
           cd kernagent
           uv sync --all-groups
 
-      - name: Check Python syntax
+      - name: Run ruff format check
+        run: |
+          cd kernagent
+          uv run ruff format --check .
+
+      - name: Run ruff linting
         run: |
           cd kernagent
-          uv run python -m py_compile *.py */**.py
+          uv run ruff check .
 
-  # Build Docker image for PRs and develop branch (test only, no push)
+  # Build Docker image for all branches and PRs (test only, no push)
   build-test:
     name: Build Docker Image (Test)
     runs-on: ubuntu-latest
-    if: github.event_name == 'pull_request' || github.ref == 'refs/heads/develop'
+    if: github.event_name == 'pull_request' || (github.event_name == 'push' && !startsWith(github.ref, 'refs/tags/'))
     needs: [test, lint]
     env:
       TEST_CONTAINER_NAME: kernagent-test-${{ github.run_id }}
@@ -86,30 +107,34 @@ jobs:
         with:
           context: .
           push: false
-          platforms: linux/amd64
+          platforms: ${{ (github.event_name == 'workflow_dispatch' && inputs.test_multiplatform) && 'linux/amd64,linux/arm64' || 'linux/amd64' }}
           tags: kernagent:test
           cache-from: type=gha
           cache-to: type=gha,mode=max
-          load: true
+          load: ${{ !(github.event_name == 'workflow_dispatch' && inputs.test_multiplatform) }}  # Can't load multi-platform images
 
       - name: Create container for pytest run
+        if: ${{ !(github.event_name == 'workflow_dispatch' && inputs.test_multiplatform) }}
         run: |
           docker create --name "$TEST_CONTAINER_NAME" \
             --entrypoint "" \
             kernagent:test \
             python -m pytest /workspace/project/tests -v
 
       - name: Copy tests into container
+        if: ${{ !(github.event_name == 'workflow_dispatch' && inputs.test_multiplatform) }}
         run: docker cp tests "$TEST_CONTAINER_NAME":/workspace/project/
 
       - name: Run pytest inside Docker image
+        if: ${{ !(github.event_name == 'workflow_dispatch' && inputs.test_multiplatform) }}
         run: docker start -a "$TEST_CONTAINER_NAME"
 
       - name: Remove test container
-        if: always()
+        if: always() && !(github.event_name == 'workflow_dispatch' && inputs.test_multiplatform)
         run: docker rm -f "$TEST_CONTAINER_NAME"
 
       - name: Test CLI help command
+        if: ${{ !(github.event_name == 'workflow_dispatch' && inputs.test_multiplatform) }}
         run: |
           docker run --rm kernagent:test --help
 
@@ -119,6 +144,9 @@ jobs:
     runs-on: ubuntu-latest
     if: startsWith(github.ref, 'refs/tags/v')
     needs: [test, lint]
+    permissions:
+      contents: write  # Needed to create GitHub Release
+      packages: write  # Needed to push to GHCR
 
     steps:
       - name: Checkout code
@@ -159,48 +187,9 @@ jobs:
           cache-to: type=gha,mode=max
           provenance: false
 
-      - name: Generate release notes
-        id: release_notes
-        run: |
-          # Extract version from tag
-          VERSION=${GITHUB_REF#refs/tags/}
-          echo "version=$VERSION" >> $GITHUB_OUTPUT
-
-          # Generate release notes from commits since last tag
-          PREV_TAG=$(git describe --abbrev=0 --tags ${GITHUB_REF}^ 2>/dev/null || echo "")
-          if [ -n "$PREV_TAG" ]; then
-            echo "## Changes since $PREV_TAG" > release_notes.md
-            git log $PREV_TAG..HEAD --pretty=format:"- %s (%h)" >> release_notes.md
-          else
-            echo "## Initial Release" > release_notes.md
-            echo "First release of kernagent" >> release_notes.md
-          fi
-
-          # Add installation instructions
-          cat >> release_notes.md << 'EOF'
-
-          ## Installation
-
-          **Quick install (Linux/macOS/WSL2):**
-          ```bash
-          bash <(curl -fsSL https://raw.githubusercontent.com/Karib0u/kernagent/$VERSION/install.sh)
-          ```
-
-          **Docker:**
-          ```bash
-          docker pull ghcr.io/karib0u/kernagent:$VERSION
-          ```
-
-          **See the [README](https://github.com/Karib0u/kernagent#readme) for full documentation.**
-          EOF
-
-          # Replace $VERSION placeholder
-          sed -i "s/\$VERSION/$VERSION/g" release_notes.md
-
       - name: Create GitHub Release
         uses: softprops/action-gh-release@v1
         with:
-          body_path: release_notes.md
           draft: false
           prerelease: false
           generate_release_notes: true
@@ -213,6 +202,9 @@ jobs:
     runs-on: ubuntu-latest
     if: github.ref == 'refs/heads/develop' && github.event_name == 'push'
     needs: [test, lint]
+    permissions:
+      contents: read
+      packages: write  # Needed to push to GHCR
 
     steps:
       - name: Checkout code

.gitignore

@@ -23,4 +23,7 @@ samples/
 
 # MacOS
 
-.DS_Store
+.DS_Store
+
+# Demo
+demo/

CHANGELOG.md

@@ -0,0 +1,37 @@
+# Changelog
+
+All notable changes to this project will be documented in this file.
+
+The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.0.0/),
+and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
+
+## [1.1.0] - 2025-12-06
+
+### Added
+- Context handling system for improved binary analysis workflow
+- Conversation history management in agent
+- New snapshot fixtures for testing
+- Enhanced CLI output handling and user experience
+- Comprehensive test coverage for conversation history management
+
+### Changed
+- **BREAKING:** Adopted opinionated 4-command CLI architecture (init, snapshot, analyze, chat)
+- Major refactor: modular installation system with improved scripts
+- Updated Dockerfile for better functionality
+- Enhanced message handling in ReverseEngineeringAgent
+- Improved CLI banner presentation
+
+### Fixed
+- CI release notes now fetch full git history to detect previous tags
+- ASCII art logo rendering in CLI banner
+
+### Documentation
+- Complete documentation overhaul
+- Added license compliance (NOTICE file)
+- Updated README with new CLI architecture
+
+### Removed
+- Deprecated prompts from prompts.py
+
+[1.1.0]: https://github.com/Karib0u/kernagent/compare/v1.0.3...v1.1.0
+[1.0.2]: https://github.com/Karib0u/kernagent/releases/tag/v1.0.2

Dockerfile

@@ -102,6 +102,10 @@ RUN find "${GHIDRA_INSTALL_DIR}/Ghidra/Features/Decompiler/os" -type f -name "de
 
 # Python configuration
 ENV PYTHONUNBUFFERED=1
+# Force color output in Docker (rich library)
+ENV FORCE_COLOR=1
+# Set safe default terminal width to prevent wrapping
+ENV COLUMNS=100
 
 # Copy application sources and install dependencies with uv
 WORKDIR /workspace/project
@@ -110,22 +114,8 @@ WORKDIR /workspace/project
 COPY pyproject.toml uv.lock /workspace/project/
 COPY README.md /workspace/project/README.md
 
-# Create the kernagent package directory and copy Python sources
-RUN mkdir -p /workspace/project/kernagent
-COPY kernagent/__init__.py \
-     kernagent/__main__.py \
-     kernagent/agent.py \
-     kernagent/capa_runner.py \
-     kernagent/cli.py \
-     kernagent/config.py \
-     kernagent/llm_client.py \
-     kernagent/log.py \
-     kernagent/prompts.py \
-     /workspace/project/kernagent/
-
-# Copy subdirectories
-COPY kernagent/oneshot /workspace/project/kernagent/oneshot
-COPY kernagent/snapshot /workspace/project/kernagent/snapshot
+# Copy the entire kernagent package so new modules are automatically included
+COPY kernagent /workspace/project/kernagent
 
 # Pin Python version to 3.12 (python-flirt doesn't have wheels for 3.14 yet)
 ENV UV_PYTHON=3.12
@@ -142,5 +132,6 @@ ENV PATH="${VIRTUAL_ENV}/bin:${PATH}"
 VOLUME /data
 
 # Run the CLI directly from the virtual environment
-ENTRYPOINT ["python", "-m", "kernagent.cli"]
+# -u flag forces unbuffered stdout/stderr for reliable streaming in Docker
+ENTRYPOINT ["python", "-u", "-m", "kernagent"]
 CMD ["--help"]