empathy-framework 4.6.0__tar.gz → 4.6.1__tar.gz

{empathy_framework-4.6.0 → empathy_framework-4.6.1}/CHANGELOG.md

@@ -5,6 +5,73 @@ All notable changes to the Empathy Framework 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).
 
+## [4.6.1] - 2026-01-20
+
+### Fixed
+
+- **README code example** - Fixed `os.collaborate()` to use actual `level_2_guided()` method
+- **README skills table** - Added all 13 skills (was showing only 7)
+- **CHANGELOG** - Added missing v4.6.0 release notes
+
+## [4.6.0] - 2026-01-20
+
+### Added - $0 COST AI WORKFLOWS 💰
+
+#### Claude Code Integration
+- **$0 Execution Model** - All multi-agent workflows now run at no additional cost with any Claude Code subscription
+  - Workflows use Claude Code's Task tool instead of direct API calls
+  - Enterprise API mode remains available for CI/CD, cron jobs, and programmatic control
+  - **Files**: `.claude/commands/*.md`
+
+- **Socratic Agent Creation** - New guided workflows for building custom agents
+  - `/create-agent` - 6-step Socratic guide to build custom AI agents
+  - `/create-team` - 7-step Socratic guide to build multi-agent teams
+  - Progressive questioning using AskUserQuestion tool
+  - Model tier selection (Haiku/Sonnet/Opus)
+  - Optional memory enhancement (short-term and long-term)
+  - **Files**: `.claude/commands/create-agent.md`, `.claude/commands/create-team.md`
+
+- **Memory Enhancement for Agents** - Optional memory features for custom agents
+  - Short-term memory: Session-scoped context sharing between agents
+  - Long-term memory: Persistent pattern storage across sessions
+  - Integration with `/memory` skill for pattern recall
+  - **Files**: `.claude/commands/create-agent.md`, `.claude/commands/create-team.md`
+
+#### Streamlined Skills (13 Total)
+- **Multi-Agent Workflows ($0)**:
+  - `/release-prep` - 4-agent release readiness check
+  - `/test-coverage` - 3-agent coverage analysis
+  - `/test-maintenance` - 4-agent test health analysis
+  - `/manage-docs` - 3-agent documentation sync
+  - `/feature-overview` - Technical documentation generator
+
+- **Utility Skills**:
+  - `/security-scan` - Run pytest, ruff, black checks
+  - `/test` - Run test suite
+  - `/status` - Project dashboard
+  - `/publish` - PyPI publishing guide
+  - `/init` - Initialize new project
+  - `/memory` - Memory system management
+
+### Removed
+- 10 API-dependent skills that required external API calls:
+  - `/marketing`, `/draft`, `/morning-report` - Marketing (now gitignored)
+  - `/crew` - CrewAI integration
+  - `/cost-report`, `/cache` - API telemetry
+  - `/docs`, `/refactor`, `/perf`, `/deps` - API workflows
+
+### Changed
+- **VS Code Dashboard** - Now prefers Claude Code skills ($0) over API mode
+  - Health Check, Release Prep, Test Coverage buttons use skills first
+  - Falls back to API mode only when Claude Code extension not installed
+  - Updated fallback message to clarify API mode is enterprise feature
+  - **Files**: `vscode-extension/src/panels/EmpathyDashboardPanel.ts`
+
+- **Marketing folder** moved to .gitignore (internal/admin only)
+
+### Fixed
+- Test file Stripe API key pattern changed to use `sk_test_` prefix to avoid GitHub push protection
+
 ## [4.5.1] - 2026-01-20
 
 ### Changed

{empathy_framework-4.6.0 → empathy_framework-4.6.1}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: empathy-framework
-Version: 4.6.0
+Version: 4.6.1
 Summary: AI collaboration framework with real LLM agent execution, AskUserQuestion tool integration, Socratic agent generation, progressive tier escalation (70-85% cost savings), meta-orchestration, dynamic agent composition (6 patterns), intelligent caching (85% hit rate), semantic workflow discovery, visual workflow editor, MCP integration for Claude Code, and multi-agent orchestration.
 Author-email: Patrick Roebuck <admin@smartaimemory.com>
 Maintainer-email: Smart-AI-Memory <admin@smartaimemory.com>
@@ -394,7 +394,7 @@ pip install empathy-framework[developer]  # Lightweight for individual developer
 /test-coverage    # 3-agent coverage analysis ($0)
 ```
 
-**Available Skills:**
+**Available Skills (13 total):**
 
 | Skill | Description | Cost |
 |-------|-------------|------|
@@ -405,6 +405,12 @@ pip install empathy-framework[developer]  # Lightweight for individual developer
 | `/test-maintenance` | Find stale/flaky tests | $0 |
 | `/manage-docs` | Keep docs in sync with code | $0 |
 | `/feature-overview` | Generate technical documentation | $0 |
+| `/security-scan` | Run pytest, ruff, black checks | $0 |
+| `/test` | Run test suite with summary | $0 |
+| `/status` | Show project dashboard | $0 |
+| `/publish` | PyPI publishing guide | $0 |
+| `/init` | Initialize new Empathy project | $0 |
+| `/memory` | Memory system management | $0 |
 
 **Enterprise API Mode** (optional):
 
@@ -940,15 +946,15 @@ python -m empathy_os.models.cli provider --set hybrid  # Best of all providers
 ```python
 from empathy_os import EmpathyOS
 
-os = EmpathyOS()
-result = await os.collaborate(
-    "Review this code for security issues",
-    context={"code": your_code}
-)
+async with EmpathyOS() as empathy:
+    # Level 2: Guided - asks clarifying questions
+    result = await empathy.level_2_guided(
+        "Review this code for security issues"
+    )
 
-print(result.current_issues)      # What's wrong now
-print(result.predicted_issues)    # What will break in 30-90 days
-print(result.prevention_steps)    # How to prevent it
+    print(result["questions"])        # Clarifying questions asked
+    print(result["response"])         # Analysis response
+    print(result["next_steps"])       # Recommended actions
 ```
 
 ### 4. Track Your Savings

{empathy_framework-4.6.0 → empathy_framework-4.6.1}/README.md

@@ -37,7 +37,7 @@ pip install empathy-framework[developer]  # Lightweight for individual developer
 /test-coverage    # 3-agent coverage analysis ($0)
 ```
 
-**Available Skills:**
+**Available Skills (13 total):**
 
 | Skill | Description | Cost |
 |-------|-------------|------|
@@ -48,6 +48,12 @@ pip install empathy-framework[developer]  # Lightweight for individual developer
 | `/test-maintenance` | Find stale/flaky tests | $0 |
 | `/manage-docs` | Keep docs in sync with code | $0 |
 | `/feature-overview` | Generate technical documentation | $0 |
+| `/security-scan` | Run pytest, ruff, black checks | $0 |
+| `/test` | Run test suite with summary | $0 |
+| `/status` | Show project dashboard | $0 |
+| `/publish` | PyPI publishing guide | $0 |
+| `/init` | Initialize new Empathy project | $0 |
+| `/memory` | Memory system management | $0 |
 
 **Enterprise API Mode** (optional):
 
@@ -583,15 +589,15 @@ python -m empathy_os.models.cli provider --set hybrid  # Best of all providers
 ```python
 from empathy_os import EmpathyOS
 
-os = EmpathyOS()
-result = await os.collaborate(
-    "Review this code for security issues",
-    context={"code": your_code}
-)
+async with EmpathyOS() as empathy:
+    # Level 2: Guided - asks clarifying questions
+    result = await empathy.level_2_guided(
+        "Review this code for security issues"
+    )
 
-print(result.current_issues)      # What's wrong now
-print(result.predicted_issues)    # What will break in 30-90 days
-print(result.prevention_steps)    # How to prevent it
+    print(result["questions"])        # Clarifying questions asked
+    print(result["response"])         # Analysis response
+    print(result["next_steps"])       # Recommended actions
 ```
 
 ### 4. Track Your Savings

empathy_framework-4.6.1/docs/examples/generated-plan-release-prep.md

@@ -0,0 +1,250 @@
+# Execution Plan: Release Preparation
+
+> Generated by Empathy Framework v4.5.1
+> Template: release-prep
+> Generated: 2026-01-20T13:30:00Z
+
+## Configuration
+
+Based on form responses (or defaults):
+- **security_scan**: Yes
+- **test_coverage_check**: Yes
+- **coverage_threshold**: 80%
+- **quality_review**: Yes
+- **doc_verification**: Yes
+
+---
+
+## Agent Execution Plan
+
+Execute these steps sequentially. Each step can be run as a Claude Code Task agent.
+
+### Step 1: Security Auditor
+
+**Role**: Security Auditor
+**Tier Recommendation**: CAPABLE (Sonnet)
+**Tools Needed**: grep, file search, code analysis
+
+**Prompt for Claude Code:**
+```
+You are a Security Auditor analyzing this codebase for release readiness.
+
+Your task:
+1. Scan for OWASP Top 10 vulnerabilities (injection, XSS, auth issues)
+2. Check for hardcoded secrets or credentials
+3. Review dependency security (look for known vulnerable packages)
+4. Identify any unsafe patterns (eval, exec, unsanitized input)
+
+Focus areas:
+- src/ directory for application code
+- Look for patterns: eval(, exec(, subprocess with shell=True
+- Check .env files aren't committed
+- Review authentication/authorization code
+
+Success Criteria:
+- [ ] No critical vulnerabilities found
+- [ ] All dependencies are secure
+- [ ] No hardcoded secrets
+
+Output a structured report with:
+- CRITICAL issues (must fix before release)
+- HIGH issues (should fix)
+- MEDIUM issues (consider fixing)
+- Recommendations
+```
+
+**Claude Code invocation:**
+```
+Use the Task tool with subagent_type="Explore" and this prompt.
+Or run directly in conversation.
+```
+
+---
+
+### Step 2: Test Coverage Analyst
+
+**Role**: Test Coverage Analyst
+**Tier Recommendation**: CAPABLE (start), escalate to PREMIUM if complex
+**Tools Needed**: pytest, coverage analysis
+
+**Prompt for Claude Code:**
+```
+You are a Test Coverage Analyst verifying test coverage for release.
+
+Your task:
+1. Run the test suite and check coverage: pytest --cov=src --cov-report=term-missing
+2. Identify files/functions with coverage below 80%
+3. Analyze which uncovered paths are high-risk
+4. Check for any failing tests
+
+Configuration:
+- Minimum threshold: 80%
+- Focus on src/empathy_os/ directory
+
+Success Criteria:
+- [ ] Coverage meets 80% threshold
+- [ ] All tests pass
+- [ ] Critical paths are covered
+
+Output:
+- Current coverage percentage
+- List of under-covered files (sorted by risk)
+- Specific functions needing tests
+- Any test failures with analysis
+```
+
+**Claude Code invocation:**
+```bash
+# Run this first to get data:
+pytest --cov=src --cov-report=term-missing -q
+
+# Then analyze the output
+```
+
+---
+
+### Step 3: Code Quality Reviewer
+
+**Role**: Code Quality Reviewer
+**Tier Recommendation**: CAPABLE
+**Tools Needed**: ruff, code search
+
+**Prompt for Claude Code:**
+```
+You are a Code Quality Reviewer checking code quality for release.
+
+Your task:
+1. Run linting: ruff check src/ --statistics
+2. Identify code smells and complexity issues
+3. Check for TODO/FIXME comments that should be addressed
+4. Review recent changes for quality issues
+
+Focus on:
+- Functions with high cyclomatic complexity
+- Duplicate code patterns
+- Missing type hints on public APIs
+- Error handling patterns
+
+Success Criteria:
+- [ ] No high-severity linting issues
+- [ ] Complexity within acceptable bounds
+- [ ] Critical TODOs addressed
+
+Output:
+- Summary of linting issues by severity
+- Top 5 complexity hotspots
+- List of unresolved TODOs/FIXMEs
+- Recommendations for improvement
+```
+
+---
+
+### Step 4: Documentation Specialist
+
+**Role**: Documentation Specialist
+**Tier Recommendation**: CHEAP (Haiku) - straightforward analysis
+**Tools Needed**: file search, doc analysis
+
+**Prompt for Claude Code:**
+```
+You are a Documentation Specialist verifying docs for release.
+
+Your task:
+1. Check that all public APIs have docstrings
+2. Verify README.md is current with latest features
+3. Check CHANGELOG.md has entries for this release
+4. Verify any API changes are documented
+
+Focus areas:
+- src/empathy_os/*.py - public modules
+- README.md - feature list accuracy
+- CHANGELOG.md - recent entries
+- docs/ directory - guide accuracy
+
+Success Criteria:
+- [ ] All public APIs documented
+- [ ] README reflects current features
+- [ ] CHANGELOG updated
+
+Output:
+- List of undocumented public APIs
+- README accuracy assessment
+- CHANGELOG status
+- Documentation gaps to address
+```
+
+---
+
+## Synthesis Step
+
+After all agents complete, synthesize findings:
+
+**Prompt for Claude Code:**
+```
+You are synthesizing the release readiness assessment.
+
+Combine the outputs from:
+1. Security Auditor findings
+2. Test Coverage analysis
+3. Code Quality review
+4. Documentation check
+
+Create a release readiness report:
+
+## Release Readiness Summary
+
+### Overall Status: [READY / BLOCKED / NEEDS WORK]
+
+### Critical Blockers (must fix)
+- List any critical issues
+
+### Recommended Fixes (should fix)
+- List high-priority improvements
+
+### Release Checklist
+- [ ] Security scan passed
+- [ ] Test coverage ≥80%
+- [ ] No critical quality issues
+- [ ] Documentation complete
+
+### Risk Assessment
+- What risks exist if we release now?
+- What's the recommended action?
+```
+
+---
+
+## Usage Options
+
+### Option A: Interactive (paste prompts into Claude Code)
+1. Start Claude Code conversation
+2. Copy each step's prompt
+3. Review output, proceed to next step
+4. Run synthesis at the end
+
+### Option B: As Claude Code Skill
+Save this as `.claude/commands/release-prep.md` and run with `/project:release-prep`
+
+### Option C: Automated via Task tool
+Have Claude Code run each step as a Task agent:
+```
+Run these 4 agents in sequence using the Task tool:
+1. Explore agent for security scan
+2. Bash + Explore for test coverage
+3. Explore agent for code quality
+4. Explore agent for documentation
+Then synthesize the results.
+```
+
+---
+
+## Cost Comparison
+
+| Mode | Estimated Cost |
+|------|---------------|
+| API Execution (--real) | $0.10 - $0.75 |
+| Claude Code (Max sub) | $0 (included) |
+
+---
+
+*Generated by `empathy meta-workflow plan release-prep`*

{empathy_framework-4.6.0 → empathy_framework-4.6.1}/empathy_framework.egg-info/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: empathy-framework
-Version: 4.6.0
+Version: 4.6.1
 Summary: AI collaboration framework with real LLM agent execution, AskUserQuestion tool integration, Socratic agent generation, progressive tier escalation (70-85% cost savings), meta-orchestration, dynamic agent composition (6 patterns), intelligent caching (85% hit rate), semantic workflow discovery, visual workflow editor, MCP integration for Claude Code, and multi-agent orchestration.
 Author-email: Patrick Roebuck <admin@smartaimemory.com>
 Maintainer-email: Smart-AI-Memory <admin@smartaimemory.com>
@@ -394,7 +394,7 @@ pip install empathy-framework[developer]  # Lightweight for individual developer
 /test-coverage    # 3-agent coverage analysis ($0)
 ```
 
-**Available Skills:**
+**Available Skills (13 total):**
 
 | Skill | Description | Cost |
 |-------|-------------|------|
@@ -405,6 +405,12 @@ pip install empathy-framework[developer]  # Lightweight for individual developer
 | `/test-maintenance` | Find stale/flaky tests | $0 |
 | `/manage-docs` | Keep docs in sync with code | $0 |
 | `/feature-overview` | Generate technical documentation | $0 |
+| `/security-scan` | Run pytest, ruff, black checks | $0 |
+| `/test` | Run test suite with summary | $0 |
+| `/status` | Show project dashboard | $0 |
+| `/publish` | PyPI publishing guide | $0 |
+| `/init` | Initialize new Empathy project | $0 |
+| `/memory` | Memory system management | $0 |
 
 **Enterprise API Mode** (optional):
 
@@ -940,15 +946,15 @@ python -m empathy_os.models.cli provider --set hybrid  # Best of all providers
 ```python
 from empathy_os import EmpathyOS
 
-os = EmpathyOS()
-result = await os.collaborate(
-    "Review this code for security issues",
-    context={"code": your_code}
-)
+async with EmpathyOS() as empathy:
+    # Level 2: Guided - asks clarifying questions
+    result = await empathy.level_2_guided(
+        "Review this code for security issues"
+    )
 
-print(result.current_issues)      # What's wrong now
-print(result.predicted_issues)    # What will break in 30-90 days
-print(result.prevention_steps)    # How to prevent it
+    print(result["questions"])        # Clarifying questions asked
+    print(result["response"])         # Analysis response
+    print(result["next_steps"])       # Recommended actions
 ```
 
 ### 4. Track Your Savings

{empathy_framework-4.6.0 → empathy_framework-4.6.1}/empathy_framework.egg-info/SOURCES.txt

@@ -59,6 +59,7 @@ docs/api-reference/persistence.md
 docs/api-reference/software-wizards.md
 docs/api-reference/wizards.md
 docs/examples/adaptive-learning-system.md
+docs/examples/generated-plan-release-prep.md
 docs/examples/multi-agent-team-coordination.md
 docs/examples/sbar-clinical-handoff.md
 docs/examples/simple-chatbot.md

{empathy_framework-4.6.0 → empathy_framework-4.6.1}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "setuptools.build_meta"
 
 [project]
 name = "empathy-framework"
-version = "4.6.0"
+version = "4.6.1"
 description = "AI collaboration framework with real LLM agent execution, AskUserQuestion tool integration, Socratic agent generation, progressive tier escalation (70-85% cost savings), meta-orchestration, dynamic agent composition (6 patterns), intelligent caching (85% hit rate), semantic workflow discovery, visual workflow editor, MCP integration for Claude Code, and multi-agent orchestration."
 readme = {file = "README.md", content-type = "text/markdown"}
 requires-python = ">=3.10"

{empathy_framework-4.6.0 → empathy_framework-4.6.1}/src/empathy_os/__init__.py

@@ -55,7 +55,7 @@ Copyright 2025 Smart AI Memory, LLC
 Licensed under Fair Source 0.9
 """
 
-__version__ = "4.6.0"
+__version__ = "4.6.1"
 __author__ = "Patrick Roebuck"
 __email__ = "hello@deepstudy.ai"