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>

Author: 3 people

.agentready-demo/demo-assessment-20251121-051257.json

@@ -0,0 +1,308 @@
+# 🤖 AgentReady Assessment Report
+
+| Repository | Branch | Commit | Score | Level | Date |
+|------------|--------|--------|-------|-------|------|
+| **demo-repo** | main | `87989978` | **73.1/100** | **Silver** | 2025-11-21 05:12 |
+
+---
+
+## 📊 Summary
+
+| Metric | Value |
+|--------|-------|
+| **Overall Score** | **73.1/100** |
+| **Certification Level** | **Silver** |
+| **Attributes Assessed** | 10/25 |
+| **Attributes Skipped** | 15 |
+| **Assessment Duration** | 1.8s |
+
+### Languages Detected
+
+- **Python**: 4 files
+
+### Repository Stats
+
+- **Total Files**: 7
+- **Total Lines**: 100
+
+## 🎖️ Certification Ladder
+
+- 💎 **Platinum** (90-100) 
+- 🥇 **Gold** (75-89) 
+- 🥈 **Silver** (60-74) **→ YOUR LEVEL ←**
+- 🥉 **Bronze** (40-59) 
+- ⚠️ **Needs Improvement** (0-39) 
+
+## 📋 Detailed Findings
+
+### API Documentation
+
+| Attribute | Tier | Status | Score |
+|-----------|------|--------|-------|
+| OpenAPI/Swagger Specifications | T3 | ⊘ not_applicable | — |
+
+### Build & Development
+
+| Attribute | Tier | Status | Score |
+|-----------|------|--------|-------|
+| One-Command Build/Setup | T2 | ⊘ not_applicable | — |
+| Container/Virtualization Setup | T4 | ⊘ not_applicable | — |
+
+### Code Quality
+
+| Attribute | Tier | Status | Score |
+|-----------|------|--------|-------|
+| Type Annotations | T1 | ✅ pass | 100 |
+| Cyclomatic Complexity Thresholds | T3 | ✅ pass | 100 |
+| Code Smell Elimination | T4 | ⊘ not_applicable | — |
+
+### Context Window Optimization
+
+| Attribute | Tier | Status | Score |
+|-----------|------|--------|-------|
+| CLAUDE.md Configuration Files | T1 | ✅ pass | 100 |
+| Concise Structured Documentation | T2 | ⊘ not_applicable | — |
+| File Size Limits | T2 | ⊘ not_applicable | — |
+
+### Dependency Management
+
+| Attribute | Tier | Status | Score |
+|-----------|------|--------|-------|
+| Lock Files for Reproducibility | T1 | ❌ fail | 0 |
+| Dependency Freshness & Security | T2 | ⊘ not_applicable | — |
+
+#### ❌ Lock Files for Reproducibility
+
+**Measured**: none (Threshold: at least one lock file)
+
+**Evidence**:
+- No lock files found
+
+<details><summary><strong>📝 Remediation Steps</strong></summary>
+
+
+Add lock file for dependency reproducibility
+
+1. Use npm install, poetry lock, or equivalent to generate lock file
+
+**Commands**:
+
+```bash
+npm install  # generates package-lock.json
+```
+
+</details>
+
+### Documentation Standards
+
+| Attribute | Tier | Status | Score |
+|-----------|------|--------|-------|
+| README Structure | T1 | ✅ pass | 100 |
+| Inline Documentation | T2 | ⊘ not_applicable | — |
+| Architecture Decision Records | T3 | ⊘ not_applicable | — |
+
+### Error Handling
+
+| Attribute | Tier | Status | Score |
+|-----------|------|--------|-------|
+| Structured Logging | T3 | ⊘ not_applicable | — |
+
+### Git & Version Control
+
+| Attribute | Tier | Status | Score |
+|-----------|------|--------|-------|
+| Conventional Commit Messages | T2 | ❌ fail | 0 |
+| .gitignore Completeness | T2 | ✅ pass | 100 |
+| Issue & Pull Request Templates | T4 | ⊘ not_applicable | — |
+
+#### ❌ Conventional Commit Messages
+
+**Measured**: not configured (Threshold: configured)
+
+**Evidence**:
+- No commitlint or husky configuration
+
+<details><summary><strong>📝 Remediation Steps</strong></summary>
+
+
+Configure conventional commits with commitlint
+
+1. Install commitlint
+2. Configure husky for commit-msg hook
+
+**Commands**:
+
+```bash
+npm install --save-dev @commitlint/cli @commitlint/config-conventional husky
+```
+
+</details>
+
+### Modularity
+
+| Attribute | Tier | Status | Score |
+|-----------|------|--------|-------|
+| Semantic File & Directory Naming | T3 | ⊘ not_applicable | — |
+
+### Performance
+
+| Attribute | Tier | Status | Score |
+|-----------|------|--------|-------|
+| Performance Benchmarks | T4 | ⊘ not_applicable | — |
+
+### Repository Structure
+
+| Attribute | Tier | Status | Score |
+|-----------|------|--------|-------|
+| Standard Project Layouts | T1 | ✅ pass | 100 |
+| Separation of Concerns | T2 | ⊘ not_applicable | — |
+
+### Security
+
+| Attribute | Tier | Status | Score |
+|-----------|------|--------|-------|
+| Security Scanning Automation | T4 | ⊘ not_applicable | — |
+
+### Testing & CI/CD
+
+| Attribute | Tier | Status | Score |
+|-----------|------|--------|-------|
+| Test Coverage Requirements | T2 | ❌ fail | 50 |
+| Pre-commit Hooks & CI/CD Linting | T2 | ❌ fail | 0 |
+
+#### ❌ Test Coverage Requirements
+
+**Measured**: not configured (Threshold: configured with >80% threshold)
+
+**Evidence**:
+- Coverage config: ✓
+- pytest-cov: ✗
+
+<details><summary><strong>📝 Remediation Steps</strong></summary>
+
+
+Configure test coverage with ≥80% threshold
+
+1. Install coverage tool (pytest-cov for Python, jest for JavaScript)
+2. Configure coverage threshold in project config
+3. Add coverage reporting to CI/CD pipeline
+4. Run coverage locally before committing
+
+**Commands**:
+
+```bash
+# Python
+pip install pytest-cov
+pytest --cov=src --cov-report=term-missing --cov-fail-under=80
+
+# JavaScript
+npm install --save-dev jest
+npm test -- --coverage --coverageThreshold='{\'global\': {\'lines\': 80}}'
+```
+
+**Examples**:
+
+```
+# Python - pyproject.toml
+[tool.pytest.ini_options]
+addopts = "--cov=src --cov-report=term-missing"
+
+[tool.coverage.report]
+fail_under = 80
+
+```
+```
+// JavaScript - package.json
+{
+  "jest": {
+    "coverageThreshold": {
+      "global": {
+        "lines": 80,
+        "statements": 80,
+        "functions": 80,
+        "branches": 80
+      }
+    }
+  }
+}
+
+```
+
+</details>
+
+#### ❌ Pre-commit Hooks & CI/CD Linting
+
+**Measured**: not configured (Threshold: configured)
+
+**Evidence**:
+- .pre-commit-config.yaml not found
+
+<details><summary><strong>📝 Remediation Steps</strong></summary>
+
+
+Configure pre-commit hooks for automated code quality checks
+
+1. Install pre-commit framework
+2. Create .pre-commit-config.yaml
+3. Add hooks for linting and formatting
+4. Install hooks: pre-commit install
+5. Run on all files: pre-commit run --all-files
+
+**Commands**:
+
+```bash
+pip install pre-commit
+pre-commit install
+pre-commit run --all-files
+```
+
+**Examples**:
+
+```
+# .pre-commit-config.yaml
+repos:
+  - repo: https://github.com/pre-commit/pre-commit-hooks
+    rev: v4.4.0
+    hooks:
+      - id: trailing-whitespace
+      - id: end-of-file-fixer
+      - id: check-yaml
+      - id: check-added-large-files
+
+  - repo: https://github.com/psf/black
+    rev: 23.3.0
+    hooks:
+      - id: black
+
+  - repo: https://github.com/pycqa/isort
+    rev: 5.12.0
+    hooks:
+      - id: isort
+
+```
+
+</details>
+
+## 🎯 Next Steps
+
+**Priority Improvements** (highest impact first):
+
+1. **Lock Files for Reproducibility** (Tier 1) - +10.0 points potential
+   - Add lock file for dependency reproducibility
+2. **Pre-commit Hooks & CI/CD Linting** (Tier 2) - +3.0 points potential
+   - Configure pre-commit hooks for automated code quality checks
+3. **Conventional Commit Messages** (Tier 2) - +3.0 points potential
+   - Configure conventional commits with commitlint
+4. **Test Coverage Requirements** (Tier 2) - +3.0 points potential
+   - Configure test coverage with ≥80% threshold
+
+---
+
+## 📝 Assessment Metadata
+
+- **Tool Version**: AgentReady v1.0.0
+- **Research Report**: Bundled version
+- **Repository Snapshot**: 8798997839b602cbb3f02073ca66ed95abc6cdda
+- **Assessment Duration**: 1.8s
+
+🤖 Generated with [Claude Code](https://claude.com/claude-code)