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

{empathy_framework-4.5.1 → 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.5.1 → empathy_framework-4.6.1}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: empathy-framework
-Version: 4.5.1
+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>
@@ -359,7 +359,7 @@ Dynamic: license-file
 
 **The AI collaboration framework with breakthrough meta-orchestration - agents that compose themselves.**
 
-🎭 **v4.5: Production-Ready Agent Teams** - Real LLM execution, VS Code integration, rich reports.
+🎭 **v4.6: $0 Cost AI Workflows** - Run agent teams free with any Claude Code subscription, Socratic agent creation, memory-enhanced learning.
 
 [![PyPI](https://img.shields.io/pypi/v/empathy-framework)](https://pypi.org/project/empathy-framework/)
 [![Tests](https://img.shields.io/badge/tests-7%2C200%2B%20passing-brightgreen)](https://github.com/Smart-AI-Memory/empathy-framework/actions)
@@ -372,6 +372,55 @@ Dynamic: license-file
 pip install empathy-framework[developer]  # Lightweight for individual developers
 ```
 
+## What's New in v4.6.0 💰 **$0 COST AI WORKFLOWS**
+
+### **Run Agent Teams Free with Any Claude Code Subscription**
+
+**v4.6** revolutionizes how you use Empathy Framework - all multi-agent workflows now run **at no additional cost** when you have any Claude Code subscription.
+
+**Key Features:**
+
+- 💰 **$0 Execution** - Agent teams use Claude Code's Task tool instead of API calls
+- 🎓 **Socratic Agent Creation** - `/create-agent` and `/create-team` guide you through building custom agents
+- 🧠 **Memory Enhancement** - Optional short-term and long-term memory for agents that learn
+- 🧹 **Streamlined Skills** - 13 clean skills that work without API keys
+
+**Quick Start (Claude Code):**
+
+```
+/create-agent     # Walk through creating a custom AI agent
+/create-team      # Build a multi-agent team with guided questions
+/release-prep     # Run 4-agent release readiness check ($0)
+/test-coverage    # 3-agent coverage analysis ($0)
+```
+
+**Available Skills (13 total):**
+
+| Skill | Description | Cost |
+|-------|-------------|------|
+| `/create-agent` | Socratic guide to build custom agents | $0 |
+| `/create-team` | Build multi-agent teams interactively | $0 |
+| `/release-prep` | Security, coverage, quality, docs check | $0 |
+| `/test-coverage` | Coverage gap analysis + suggestions | $0 |
+| `/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):
+
+```bash
+# For CI/CD, cron jobs, or programmatic control
+empathy meta-workflow run release-prep --real --use-defaults
+```
+
+---
+
 ## What's New in v4.5.0 🖥️ **VS CODE INTEGRATION**
 
 ### **Rich HTML Reports for Agent Team Execution**
@@ -897,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
@@ -1469,7 +1518,7 @@ For those interested in the development history and architectural decisions:
 
 - **[Development Logs](https://github.com/Smart-AI-Memory/empathy-framework/tree/main/docs/development-logs/)** — Execution plans, phase completions, and progress tracking
 - **[Architecture Docs](https://github.com/Smart-AI-Memory/empathy-framework/tree/main/docs/architecture/)** — System design, memory architecture, and integration plans
-- **[Marketing Materials](https://github.com/Smart-AI-Memory/empathy-framework/tree/main/docs/marketing/)** — Pitch decks, outreach templates, and commercial readiness
+- **[Claude Code Skills](.claude/commands/)** — AI-powered workflows and custom agent creation
 - **[Guides](https://github.com/Smart-AI-Memory/empathy-framework/tree/main/docs/guides/)** — Publishing tutorials, MkDocs setup, and distribution policies
 
 ---

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

@@ -2,7 +2,7 @@
 
 **The AI collaboration framework with breakthrough meta-orchestration - agents that compose themselves.**
 
-🎭 **v4.5: Production-Ready Agent Teams** - Real LLM execution, VS Code integration, rich reports.
+🎭 **v4.6: $0 Cost AI Workflows** - Run agent teams free with any Claude Code subscription, Socratic agent creation, memory-enhanced learning.
 
 [![PyPI](https://img.shields.io/pypi/v/empathy-framework)](https://pypi.org/project/empathy-framework/)
 [![Tests](https://img.shields.io/badge/tests-7%2C200%2B%20passing-brightgreen)](https://github.com/Smart-AI-Memory/empathy-framework/actions)
@@ -15,6 +15,55 @@
 pip install empathy-framework[developer]  # Lightweight for individual developers
 ```
 
+## What's New in v4.6.0 💰 **$0 COST AI WORKFLOWS**
+
+### **Run Agent Teams Free with Any Claude Code Subscription**
+
+**v4.6** revolutionizes how you use Empathy Framework - all multi-agent workflows now run **at no additional cost** when you have any Claude Code subscription.
+
+**Key Features:**
+
+- 💰 **$0 Execution** - Agent teams use Claude Code's Task tool instead of API calls
+- 🎓 **Socratic Agent Creation** - `/create-agent` and `/create-team` guide you through building custom agents
+- 🧠 **Memory Enhancement** - Optional short-term and long-term memory for agents that learn
+- 🧹 **Streamlined Skills** - 13 clean skills that work without API keys
+
+**Quick Start (Claude Code):**
+
+```
+/create-agent     # Walk through creating a custom AI agent
+/create-team      # Build a multi-agent team with guided questions
+/release-prep     # Run 4-agent release readiness check ($0)
+/test-coverage    # 3-agent coverage analysis ($0)
+```
+
+**Available Skills (13 total):**
+
+| Skill | Description | Cost |
+|-------|-------------|------|
+| `/create-agent` | Socratic guide to build custom agents | $0 |
+| `/create-team` | Build multi-agent teams interactively | $0 |
+| `/release-prep` | Security, coverage, quality, docs check | $0 |
+| `/test-coverage` | Coverage gap analysis + suggestions | $0 |
+| `/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):
+
+```bash
+# For CI/CD, cron jobs, or programmatic control
+empathy meta-workflow run release-prep --real --use-defaults
+```
+
+---
+
 ## What's New in v4.5.0 🖥️ **VS CODE INTEGRATION**
 
 ### **Rich HTML Reports for Agent Team Execution**
@@ -540,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
@@ -1112,7 +1161,7 @@ For those interested in the development history and architectural decisions:
 
 - **[Development Logs](https://github.com/Smart-AI-Memory/empathy-framework/tree/main/docs/development-logs/)** — Execution plans, phase completions, and progress tracking
 - **[Architecture Docs](https://github.com/Smart-AI-Memory/empathy-framework/tree/main/docs/architecture/)** — System design, memory architecture, and integration plans
-- **[Marketing Materials](https://github.com/Smart-AI-Memory/empathy-framework/tree/main/docs/marketing/)** — Pitch decks, outreach templates, and commercial readiness
+- **[Claude Code Skills](.claude/commands/)** — AI-powered workflows and custom agent creation
 - **[Guides](https://github.com/Smart-AI-Memory/empathy-framework/tree/main/docs/guides/)** — Publishing tutorials, MkDocs setup, and distribution policies
 
 ---

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.5.1 → empathy_framework-4.6.1}/empathy_framework.egg-info/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: empathy-framework
-Version: 4.5.1
+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>
@@ -359,7 +359,7 @@ Dynamic: license-file
 
 **The AI collaboration framework with breakthrough meta-orchestration - agents that compose themselves.**
 
-🎭 **v4.5: Production-Ready Agent Teams** - Real LLM execution, VS Code integration, rich reports.
+🎭 **v4.6: $0 Cost AI Workflows** - Run agent teams free with any Claude Code subscription, Socratic agent creation, memory-enhanced learning.
 
 [![PyPI](https://img.shields.io/pypi/v/empathy-framework)](https://pypi.org/project/empathy-framework/)
 [![Tests](https://img.shields.io/badge/tests-7%2C200%2B%20passing-brightgreen)](https://github.com/Smart-AI-Memory/empathy-framework/actions)
@@ -372,6 +372,55 @@ Dynamic: license-file
 pip install empathy-framework[developer]  # Lightweight for individual developers
 ```
 
+## What's New in v4.6.0 💰 **$0 COST AI WORKFLOWS**
+
+### **Run Agent Teams Free with Any Claude Code Subscription**
+
+**v4.6** revolutionizes how you use Empathy Framework - all multi-agent workflows now run **at no additional cost** when you have any Claude Code subscription.
+
+**Key Features:**
+
+- 💰 **$0 Execution** - Agent teams use Claude Code's Task tool instead of API calls
+- 🎓 **Socratic Agent Creation** - `/create-agent` and `/create-team` guide you through building custom agents
+- 🧠 **Memory Enhancement** - Optional short-term and long-term memory for agents that learn
+- 🧹 **Streamlined Skills** - 13 clean skills that work without API keys
+
+**Quick Start (Claude Code):**
+
+```
+/create-agent     # Walk through creating a custom AI agent
+/create-team      # Build a multi-agent team with guided questions
+/release-prep     # Run 4-agent release readiness check ($0)
+/test-coverage    # 3-agent coverage analysis ($0)
+```
+
+**Available Skills (13 total):**
+
+| Skill | Description | Cost |
+|-------|-------------|------|
+| `/create-agent` | Socratic guide to build custom agents | $0 |
+| `/create-team` | Build multi-agent teams interactively | $0 |
+| `/release-prep` | Security, coverage, quality, docs check | $0 |
+| `/test-coverage` | Coverage gap analysis + suggestions | $0 |
+| `/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):
+
+```bash
+# For CI/CD, cron jobs, or programmatic control
+empathy meta-workflow run release-prep --real --use-defaults
+```
+
+---
+
 ## What's New in v4.5.0 🖥️ **VS CODE INTEGRATION**
 
 ### **Rich HTML Reports for Agent Team Execution**
@@ -897,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
@@ -1469,7 +1518,7 @@ For those interested in the development history and architectural decisions:
 
 - **[Development Logs](https://github.com/Smart-AI-Memory/empathy-framework/tree/main/docs/development-logs/)** — Execution plans, phase completions, and progress tracking
 - **[Architecture Docs](https://github.com/Smart-AI-Memory/empathy-framework/tree/main/docs/architecture/)** — System design, memory architecture, and integration plans
-- **[Marketing Materials](https://github.com/Smart-AI-Memory/empathy-framework/tree/main/docs/marketing/)** — Pitch decks, outreach templates, and commercial readiness
+- **[Claude Code Skills](.claude/commands/)** — AI-powered workflows and custom agent creation
 - **[Guides](https://github.com/Smart-AI-Memory/empathy-framework/tree/main/docs/guides/)** — Publishing tutorials, MkDocs setup, and distribution policies
 
 ---

{empathy_framework-4.5.1 → 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
@@ -411,6 +412,7 @@ src/empathy_os/meta_workflows/form_engine.py
 src/empathy_os/meta_workflows/intent_detector.py
 src/empathy_os/meta_workflows/models.py
 src/empathy_os/meta_workflows/pattern_learner.py
+src/empathy_os/meta_workflows/plan_generator.py
 src/empathy_os/meta_workflows/session_context.py
 src/empathy_os/meta_workflows/template_registry.py
 src/empathy_os/meta_workflows/workflow.py
@@ -627,13 +629,25 @@ tests/test_feedback_loops.py
 tests/test_finding_extraction.py
 tests/test_graph.py
 tests/test_health_check.py
+tests/test_healthcare_plugin.py
 tests/test_intelligence_integration.py
 tests/test_levels.py
 tests/test_leverage_points.py
 tests/test_linter_parsers.py
 tests/test_llm_integration.py
+tests/test_llm_toolkit_agents.py
+tests/test_llm_toolkit_core.py
+tests/test_llm_toolkit_decorators.py
+tests/test_llm_toolkit_empathy_core.py
 tests/test_llm_toolkit_langgraph_adapter.py
 tests/test_llm_toolkit_levels.py
+tests/test_llm_toolkit_memory.py
+tests/test_llm_toolkit_patterns.py
+tests/test_llm_toolkit_providers.py
+tests/test_llm_toolkit_security.py
+tests/test_llm_toolkit_session_status.py
+tests/test_llm_toolkit_wizard_adapter.py
+tests/test_llm_toolkit_wizards.py
 tests/test_logging_config.py
 tests/test_long_term.py
 tests/test_memory_graph.py