feat: Improve HTML report design with dark/professional color scheme and larger fonts by jeremyeder · Pull Request #26 · ambient-code/agentready

jeremyeder · 2025-11-21T20:03:05Z

Summary

Completely redesigned HTML report with a dark/professional color scheme and increased font sizes for better readability and professional appearance. This addresses the user feedback that the current purple gradient design was "hideous" and font sizes were too small.

Changes

Color Scheme

Base colors: Almost black (#0a0e27) with dark blue surfaces (#1a1f3a, #252b4a)
Accent color: Purple (#8b5cf6) used sparingly for visual interest
Text colors: High-contrast white/gray (#f8fafc, #cbd5e1, #94a3b8)
Status colors: Green (pass), Red (fail), Amber (warning), Gray (skipped)

Font Size Increases (+4-6pt)

Body: 14px → 18px
H1: 28px → 36px
H3: 20px → 22px
Score Display: 48px → 56px
Control Labels: 14px → 18px
Code: 13px → 16px

Visual Improvements

✅ Replaced gradient backgrounds with subtle borders and semi-transparent backgrounds
✅ Enhanced certification ladder with colored tints and purple active border
✅ Improved tier badges with semi-transparent colored backgrounds
✅ Better contrast and spacing throughout findings section
✅ Updated footer with styled links
✅ Added CSS custom properties for maintainable theming

Accessibility

✅ High contrast text on dark backgrounds (WCAG AA compliant)
✅ Color-blind friendly status indicators
✅ Focus states for interactive elements

Benefits

Professional appearance suitable for Red Hat engineering stakeholders and presentations
Improved readability on modern displays with larger, clearer text
Clean visual hierarchy with purple used as accent, not dominant color
Reduced eye strain with sophisticated dark theme
Better accessibility for color-blind users

Testing

✅ All tests passing (56 passed)
✅ Code coverage: 60%
✅ Linters passing (black, isort, ruff)
✅ Example reports regenerated and included
✅ Manual verification of HTML report in browser

Screenshots

View the redesigned report: examples/self-assessment/report-latest.html

Resolves

Closes #5 (Improve HTML Report Design - Font Size & Color Scheme)

🤖 Generated with Claude Code

Co-Authored-By: Claude noreply@anthropic.com

Add 32 tests (19 unit, 13 integration) for bootstrap functionality: - BootstrapGenerator service: 100% coverage (101/101 lines) - Bootstrap CLI: 92% coverage (37/40 lines) - Tests cover dry-run mode, file generation, language detection, template rendering, error handling, and edge cases Also fix ambiguous variable name linting error in code_quality.py (line 300: l → line for better readability) All tests passing, all linters clean. 🤖 Generated with [Claude Code](https://claude.com/claude-code) Co-Authored-By: Claude <noreply@anthropic.com>

github-actions · 2025-11-21T20:35:58Z

🎉 This PR is included in version 1.3.0 🎉

The release is available on GitHub release

Your semantic-release bot 📦🚀

#26) Add 32 tests (19 unit, 13 integration) for bootstrap functionality: - BootstrapGenerator service: 100% coverage (101/101 lines) - Bootstrap CLI: 92% coverage (37/40 lines) - Tests cover dry-run mode, file generation, language detection, template rendering, error handling, and edge cases Also fix ambiguous variable name linting error in code_quality.py (line 300: l → line for better readability) All tests passing, all linters clean. 🤖 Generated with [Claude Code](https://claude.com/claude-code) Co-authored-by: Claude <noreply@anthropic.com>

…ration (#29) * feat: Add Repomix integration for AI-friendly repository context generation Implements comprehensive Repomix integration as specified in coldstart prompt 008-repomix-integration.md. This feature enables automated repository context generation for AI consumption and improves AI-assisted development workflows. ## Features Added ### Core Components - **RepomixService** (`src/agentready/services/repomix.py`) - Configuration generation (repomix.config.json) - Ignore file generation (.repomixignore) - Repomix execution wrapper with error handling - Freshness checking (7-day default staleness threshold) - Output file management and discovery - **CLI Command** (`src/agentready/cli/repomix.py`) - `agentready repomix-generate` - Main command - `--init` - Initialize Repomix configuration - `--format` - Output format selection (markdown/xml/json/plain) - `--check` - Verify output freshness without regeneration - `--max-age` - Configurable staleness threshold - **Bootstrap Integration** (`src/agentready/cli/bootstrap.py`) - Added `--repomix` flag to bootstrap command - Auto-generates repomix.config.json and .repomixignore - Creates GitHub Actions workflow for automation - **GitHub Actions Workflow** (`src/agentready/templates/bootstrap/workflows/repomix-update.yml.j2`) - Auto-regenerates on push to main and PRs - Weekly scheduled runs (Mondays 9 AM UTC) - Manual trigger support via workflow_dispatch - PR comments when Repomix output changes - **Repomix Assessor** (`src/agentready/assessors/repomix.py`) - Tier 3 attribute (weight: 0.02) - Checks for configuration file existence - Validates output freshness (< 7 days) - Provides detailed remediation guidance ### Testing - Comprehensive unit tests (21 test cases) - RepomixService tests with mocking - Installation detection - Config/ignore generation - Freshness checks - Command execution - RepomixConfigAssessor tests - Multiple assessment scenarios - Pass/fail/partial compliance ### Documentation - Updated repomix-output.md (1.8M, 420k tokens, 156 files) - AgentReady self-assessment: **80.0/100 (Gold)** 🥇 ## Technical Details ### Architecture - Follows existing AgentReady patterns - Strategy pattern for assessor - Service layer for business logic - Template-based workflow generation ### Integration Points - Registered in main CLI (`src/agentready/cli/main.py`) - Added to bootstrap generator (`src/agentready/services/bootstrap.py`) - Included in assessor list (Tier 3 Important) ### Configuration Management - Smart defaults for Python projects - Customizable ignore patterns - Aligned with existing .gitignore patterns - Security scanning enabled by default ## Use Cases ```bash # Initialize Repomix for repository agentready repomix-generate --init # Generate AI-friendly context agentready repomix-generate # Bootstrap new repo with Repomix agentready bootstrap --repomix # Check if output is fresh agentready repomix-generate --check ``` ## Related - Coldstart Prompt: `coldstart-prompts/08-repomix-integration.md` - Priority: P4 (Enhancement) - Category: AI-Assisted Development Tools 🤖 Generated with [Claude Code](https://claude.com/claude-code) Co-Authored-By: Claude <noreply@anthropic.com> * chore(release): 1.1.2 [skip ci] ## [1.1.2](v1.1.1...v1.1.2) (2025-11-21) ### Bug Fixes * correct GitHub repository link in site navigation ([5492278](5492278)) * feat: Add automated demo command for AgentReady (#24) * feat: Add automated demo command for AgentReady Implements P0 feature to showcase AgentReady capabilities with a single command. Features: - agentready demo command creates sample repository and runs assessment - Supports Python (default) and JavaScript demo repositories - Real-time progress indicators with color-coded output (✓/✗/⊘) - Auto-opens HTML report in browser (optional --no-browser flag) - Generates HTML, Markdown, and JSON reports in .agentready-demo/ - Options: --language, --no-browser, --keep-repo Implementation: - Created src/agentready/cli/demo.py with demo command logic - Registered demo command in CLI main.py - Added comprehensive unit tests in tests/unit/test_demo.py - Demo completes in ~3-5 seconds with 25 attribute assessments Perfect for presentations, stakeholder demos, and user onboarding. Closes #1 🤖 Generated with [Claude Code](https://claude.ai/code) Co-authored-by: Jeremy Eder <jeremyeder@users.noreply.github.com> * fix: install AgentReady from source in CI workflow The workflow was attempting to install agentready from PyPI, but the package has never been published. Changed to install from checked-out repository source using 'pip install -e .' instead. This ensures CI tests the actual code in the PR rather than a potentially stale PyPI version. Fixes GitHub Actions workflow failure on PR #24. 🤖 Generated with [Claude Code](https://claude.com/claude-code) Co-Authored-By: Claude <noreply@anthropic.com> * feat: add manual PyPI publishing workflow Added workflow_dispatch workflow for manual PyPI publishing with: - Dry run mode (publishes to TestPyPI for testing) - Production mode (publishes to PyPI) - Optional version override - Automatic GitHub release creation - Built-in validation with twine check - Secure: Uses environment variables to prevent command injection Usage: 1. Configure TEST_PYPI_TOKEN and PYPI_TOKEN secrets 2. Go to Actions → "Publish to PyPI" → Run workflow 3. Choose dry run (TestPyPI) or production (PyPI) Future enhancement tracked in issue #25 for automated integration with semantic-release workflow. 🤖 Generated with [Claude Code](https://claude.com/claude-code) Co-Authored-By: Claude <noreply@anthropic.com> * feat: implement continuous learning loop with LLM-powered skill extraction Add comprehensive learning system that extracts high-quality skills from assessments: - New 'learn' CLI command with heuristic and LLM enrichment modes - Claude API integration for detailed skill analysis and instruction generation - LLM response caching system (7-day TTL) to reduce API costs - Code sampling for real repository examples - Pattern extraction from high-scoring assessment attributes - Support for multiple output formats (JSON, SKILL.md, GitHub issues) Technical additions: - src/agentready/cli/learn.py - Main learning command implementation - src/agentready/learners/ - Pattern extraction and LLM enrichment modules - src/agentready/services/llm_cache.py - LLM response caching - src/agentready/models/discovered_skill.py - Skill data model - tests/unit/learners/ - Unit tests for learning modules - .github/workflows/continuous-learning.yml - CI workflow - .github/CLAUDE_INTEGRATION.md - Integration documentation 🤖 Generated with [Claude Code](https://claude.com/claude-code) Co-Authored-By: Claude <noreply@anthropic.com> --------- Co-authored-by: claude[bot] <41898282+claude[bot]@users.noreply.github.com> Co-authored-by: Jeremy Eder <jeremyeder@users.noreply.github.com> Co-authored-by: Claude <noreply@anthropic.com> * chore(release): 1.2.0 [skip ci] # [1.2.0](v1.1.2...v1.2.0) (2025-11-21) ### Features * Add automated demo command for AgentReady ([#24](#24)) ([f4e89d9](f4e89d9)), closes [#1](#1) [#25](#25) [hi#quality](https://github.com/hi/issues/quality) [hi#scoring](https://github.com/hi/issues/scoring) * test(bootstrap): add comprehensive test coverage for bootstrap feature (#26) Add 32 tests (19 unit, 13 integration) for bootstrap functionality: - BootstrapGenerator service: 100% coverage (101/101 lines) - Bootstrap CLI: 92% coverage (37/40 lines) - Tests cover dry-run mode, file generation, language detection, template rendering, error handling, and edge cases Also fix ambiguous variable name linting error in code_quality.py (line 300: l → line for better readability) All tests passing, all linters clean. 🤖 Generated with [Claude Code](https://claude.com/claude-code) Co-authored-by: Claude <noreply@anthropic.com> * feat: add report header with repository metadata (#28) Add prominent report header showing repository context and assessment metadata to all report formats (HTML, Markdown, JSON). Changes: - Create AssessmentMetadata model to capture execution context - AgentReady version from package metadata - Assessment timestamp (ISO 8601 and human-readable) - Executed by (username@hostname) - CLI command used - Working directory - Update Assessment model with optional metadata field - Implement metadata collection in Scanner service - Get version from importlib.metadata - Reconstruct command from sys.argv - Capture user and hostname from environment - Update all reporters to display metadata - HTML: Two-column header (repo info + meta info) - Markdown: Prominent header with all metadata fields - JSON: Metadata object at top level - Add comprehensive unit tests (4 new tests, all passing) - All 37 tests passing (34 unit + 3 integration) Acceptance criteria met: ✅ User can identify repository assessed (name, path, branch, commit) ✅ Timestamp shows when assessment was run ✅ Git context visible in all reports ✅ AgentReady version tracked for reproducibility ✅ Execution context captured (user@host, command, cwd) 🤖 Generated with [Claude Code](https://claude.com/claude-code) Co-authored-by: Claude <noreply@anthropic.com> * chore(release): 1.3.0 [skip ci] # [1.3.0](v1.2.0...v1.3.0) (2025-11-21) ### Features * add report header with repository metadata ([#28](#28)) ([7a8b34a](7a8b34a)) --------- Co-authored-by: Claude <noreply@anthropic.com> Co-authored-by: semantic-release-bot <semantic-release-bot@martynus.net> Co-authored-by: claude[bot] <41898282+claude[bot]@users.noreply.github.com> Co-authored-by: Jeremy Eder <jeremyeder@users.noreply.github.com>

jeremyeder merged commit ee6ec24 into main Nov 21, 2025
5 of 11 checks passed

github-actions bot added the released label Nov 21, 2025

Provide feedback

Saved searches

Use saved searches to filter your results more quickly

feat: Improve HTML report design with dark/professional color scheme and larger fonts#26

feat: Improve HTML report design with dark/professional color scheme and larger fonts#26
jeremyeder merged 1 commit intomainfrom
003-bootstrap-agentready-repository-on-github

jeremyeder commented Nov 21, 2025

Uh oh!

Uh oh!

github-actions bot commented Nov 21, 2025

Uh oh!

Reviewers

Assignees

Labels

Projects

Milestone

Development

Uh oh!

1 participant

Conversation

jeremyeder commented Nov 21, 2025

Summary

Changes

Color Scheme

Font Size Increases (+4-6pt)

Visual Improvements

Accessibility

Benefits

Testing

Screenshots

Resolves

Uh oh!

Uh oh!

github-actions bot commented Nov 21, 2025

Uh oh!

Reviewers

Assignees

Labels

Projects

Milestone

Development

Uh oh!

1 participant