symfonic-core 4.9.0__tar.gz

symfonic_core-4.9.0/.claude/settings.local.json

@@ -0,0 +1,124 @@
+{
+  "permissions": {
+    "allow": [
+      "mcp__claude_ai_Notion__notion-fetch",
+      "mcp__claude_ai_Notion__notion-search",
+      "Bash(python3 -m venv .venv)",
+      "Bash(source .venv/bin/activate)",
+      "Bash(pip install:*)",
+      "Bash(python -c \":*)",
+      "Bash(python -c \"import langgraph.graph; print\\(dir\\(langgraph.graph\\)\\)\")",
+      "Bash(pytest tests/ -v --tb=long)",
+      "Bash(pytest tests/ -v --tb=line)",
+      "Bash(pytest tests/ -v --tb=short)",
+      "Bash(pytest tests/ --cov=symfonic.core --cov-report=term-missing)",
+      "Bash(python -m examples.minimal_agent)",
+      "mcp__claude_ai_Notion__notion-update-page",
+      "Bash(mcm team:*)",
+      "Bash(mcm store:*)",
+      "Bash(mcm query:*)",
+      "Bash(ruff check:*)",
+      "Bash(git add:*)",
+      "Bash(git push:*)",
+      "Bash(git commit:*)",
+      "Bash(find src/symfonic/core -name \"*.py\" -exec wc -l {} +)",
+      "Bash(find tests:*)",
+      "Bash(pytest tests/unit/observability/test_decorators.py -v --tb=short)",
+      "Bash(python -m examples.real_agent \"What is 2+2? Answer in one word.\")",
+      "Bash(pytest tests/ --cov=symfonic.core --cov-report=term-missing -v)",
+      "Bash(pytest tests/ -v)",
+      "Bash(pytest tests/ -q --tb=line)",
+      "WebFetch(domain:www.notion.so)",
+      "Bash(source /Users/amielsinue/Development/amsidev/products/symfonic/.venv/bin/activate)",
+      "Bash(pytest tests/ -v --tb=short --cov=symfonic.core --cov-report=term-missing)",
+      "Bash(python3 -c \"import sys,json; d=json.load\\(sys.stdin\\); print\\(json.dumps\\({k:v for k,v in d.items\\(\\) if ''''mcp'''' in k.lower\\(\\) or ''''server'''' in k.lower\\(\\) or ''''notion'''' in str\\(v\\).lower\\(\\)}, indent=2\\)\\)\")",
+      "Bash(python3 -c \"import sys,json; d=json.load\\(sys.stdin\\); print\\(json.dumps\\(d, indent=2\\)\\)\")",
+      "Bash(python -c \"import pydantic; print\\(pydantic.__version__\\)\")",
+      "Bash(pytest tests/ --co -q)",
+      "Bash(pytest tests/ --cov=symfonic.core --cov-report=term-missing -q)",
+      "Bash(pytest tests/ -v --tb=no -q)",
+      "Bash(python -m examples.agent_with_memory)",
+      "Bash(python -m examples.skill_registry)",
+      "Bash(python -m examples.tool_registry_demo)",
+      "Bash(pytest tests/integration/test_phase2_examples.py -v --tb=short)",
+      "Bash(pytest tests/ --cov=symfonic.core --cov-report=term-missing --tb=short)",
+      "Bash(python -m examples.real_agent_with_memory)",
+      "Bash(python -m examples.real_skill_registry)",
+      "Bash(python -m examples.real_tool_registry)",
+      "Bash(grep -rn 'def has' /Users/amielsinue/Development/amsidev/products/symfonic/src/symfonic/core/ --include=*.py)",
+      "Bash(pytest /Users/amielsinue/Development/amsidev/products/symfonic/tests/ -q --tb=line)",
+      "Bash(pytest tests/unit/test_import_graph.py tests/unit/streaming/ tests/unit/capabilities/ -v --tb=short)",
+      "Bash(pytest tests/unit/prompt/ tests/unit/streaming/test_event_processor.py tests/unit/capabilities/test_firecrawl.py tests/unit/capabilities/test_openai_search.py -v --tb=short)",
+      "Bash(pytest tests/ -q --tb=short)",
+      "Bash(python -m examples.e2e_basic_agent)",
+      "Bash(grep -E \"Miss|FAIL|[0-9]+$\")",
+      "Bash(python -m examples.demo_app)",
+      "Bash(python -m examples.demo_app \"What is symfonic?\" --mode degraded --verbose)",
+      "Bash(python -m examples.demo_app \"Test error\" --mode capability_error --verbose)",
+      "Bash(ls:*)",
+      "Bash(.venv/bin/python -c \"import dotenv; print\\('ok'\\)\" 2>&1)",
+      "Bash(.venv/bin/python -m examples.demo_app \"What skills do you have?\" 2>&1)",
+      "Bash(.venv/bin/python -m examples.demo_app \"Test\" --verbose --mode capability_error 2>&1)",
+      "Bash(ANTHROPIC_API_KEY= .venv/bin/python -m examples.demo_app \"Test\" --real)",
+      "Bash(echo \"EXIT: $?\")",
+      "Bash(.venv/bin/python -m pytest tests/unit/demo/ -q --tb=short 2>&1)",
+      "Bash(.venv/bin/python -m pytest tests/ -q --tb=line 2>&1)",
+      "Bash(python -m examples.demo_app \"What skills do you have?\" --verbose)",
+      "Bash(python -m examples.demo_app \"What skills do you have?\" --real)",
+      "Bash(python -m examples.demo_app \"What skills?\" --verbose)",
+      "Bash(python -m examples.demo_app \"Fetch data\" --mode capability_error --verbose)",
+      "Bash(pytest tests/unit/demo/ tests/integration/ -q --tb=short)",
+      "Bash(.venv/bin/pip index:*)",
+      "Bash(python -m examples.demo_app --verbose)",
+      "Bash(python -m examples.memory_agent)",
+      "Bash(python -m examples.skill_agent)",
+      "Bash(python -m examples.tool_agent)",
+      "Bash(python -m examples.demo_app --mode capability_error)",
+      "Bash(pdoc symfonic.core --output-dir docs/api)",
+      "Bash(for d:*)",
+      "Bash(do echo:*)",
+      "Read(//Users/amielsinue/Development/amsidev/products/symfonic/examples/**)",
+      "Bash(done)",
+      "Bash(.venv/bin/python -m pytest --co -q)",
+      "Bash(.venv/bin/python -m build --help)",
+      "Bash(.venv/bin/pip install:*)",
+      "Bash(.venv/bin/python -m build 2>&1)",
+      "Bash(chmod:*)",
+      "Bash(PYTHONPATH=src .venv/bin/python -m pdoc --output-directory docs/api --docformat google symfonic.core 2>&1)",
+      "Bash(PYTHONPATH=src .venv/bin/python -m pytest tests/integration/test_example_validation.py -v 2>&1)",
+      "Bash(PYTHONPATH=src .venv/bin/python -m pytest --tb=short -q 2>&1)",
+      "Bash(python -m build)",
+      "Bash(twine upload:*)",
+      "Bash(pytest tests/unit/test_callback_contracts.py tests/unit/test_callback_protocol.py -q --tb=short)",
+      "Bash(pip show:*)",
+      "Bash(python -c \"import symfonic.core; print\\(symfonic.core.__file__\\)\")",
+      "Bash(python -c \"import sys; print\\([p for p in sys.path if ''symfonic'' in p or ''src'' in p]\\)\")",
+      "Bash(python -c \"import symfonic.core.contracts; print\\(symfonic.core.contracts.__file__\\)\")",
+      "Bash(python -c \"from symfonic.core.contracts.callbacks import AgentStartEvent; print\\(AgentStartEvent\\)\")",
+      "Bash(python -m pytest tests/unit/test_callback_contracts.py -q --tb=short)",
+      "Bash(source /Users/amielsinue/Development/amsidev/products/symfonic-core/.venv/bin/activate)",
+      "Bash(pytest tests/unit/test_callback_contracts.py -q --tb=short)",
+      "Bash(python -c \"import symfonic.core.contracts.callbacks; print\\(''ok''\\)\")",
+      "Bash(pytest --co tests/unit/test_critical_paths.py)",
+      "Bash(python:*)",
+      "Bash(/Users/amielsinue/.pyenv/versions/3.12.9/envs/venv/bin/python -c \"import symfonic.core.contracts.callbacks; print\\('ok'\\)\" 2>&1)",
+      "Bash(/Users/amielsinue/.pyenv/versions/3.12.9/envs/venv/bin/pip install:*)",
+      "Bash(/Users/amielsinue/.pyenv/versions/3.12.9/envs/venv/bin/python -c \"from symfonic.core.contracts.callbacks import AgentStartEvent; print\\('ok'\\)\" 2>&1)",
+      "Bash(pytest:*)",
+      "Bash(python3 -c \":*)",
+      "Bash(poetry run:*)",
+      "Bash(.venv/bin/pytest --tb=short -q)",
+      "Bash(/Users/amielsinue/Development/amsidev/products/symfonic-core/.venv/bin/python -m pytest --tb=short -q)",
+      "Bash(uv run:*)",
+      "Bash(.venv/bin/pytest tests/ --tb=short -q)",
+      "Bash(find /Users/amielsinue/Development/amsidev/products/symfonic-core/src -name testing* -type f)",
+      "Bash(find /Users/amielsinue/Development/amsidev/products/symfonic-core/src -path */testing*)",
+      "Bash(find . -name doubles.py -path */tests/*)",
+      "Bash(git checkout:*)",
+      "Bash(gh pr:*)",
+      "Bash(grep -rn from.*nodes src/symfonic/core/deps.py src/symfonic/core/providers.py src/symfonic/core/graph.py src/symfonic/core/runtime.py)",
+      "Bash(.venv/bin/pytest --co -q)",
+      "Bash(python3 -m pytest --co -q)"
+    ]
+  }
+}

symfonic_core-4.9.0/.env.example

@@ -0,0 +1,8 @@
+# Symfonic Core — Environment Variables
+# Copy to .env and fill in your values:  cp .env.example .env
+
+# Required for examples/real_agent and AnthropicProvider
+ANTHROPIC_API_KEY=sk-ant-your-key-here
+
+# Optional: Override default model (default: claude-sonnet-4-20250514)
+# SYMFONIC_MODEL_NAME=claude-sonnet-4-20250514

symfonic_core-4.9.0/.gitignore

@@ -0,0 +1,36 @@
+# Python
+__pycache__/
+*.py[cod]
+*.egg-info/
+dist/
+build/
+*.egg
+
+# Virtual environments
+.venv/
+venv/
+
+# Testing
+.coverage
+htmlcov/
+.pytest_cache/
+
+# IDE
+.idea/
+.vscode/
+*.swp
+
+# Tools
+.ruff_cache/
+.mypy_cache/
+
+# Environment
+.env
+
+# Generated docs
+docs/api/
+
+# Agent memory (per-developer)
+.agent/
+**/__pycache__/
+.DS_Store

symfonic_core-4.9.0/CHANGELOG.md

@@ -0,0 +1,73 @@
+# Changelog
+
+All notable changes to symfonic-core will be documented in this file.
+
+The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.1.0/),
+and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
+
+## [0.1.0] - 2026-03-19
+
+Initial release of symfonic-core.
+
+### Added
+
+#### Phase 1 -- Graph Primitives
+- `AgentGraph` for declarative node/edge wiring
+- `AgentRuntime` execution engine with LangGraph compilation
+- `BaseAgentDeps` protocol-based dependency injection container
+- `BaseAgentState` TypedDict-based state schema
+- `TenantScope` for multi-tenant isolation
+- `ModelProvider` abstract LLM provider interface
+- `GraphPreset` pre-built graph configurations
+- `AgentConfig`, `ModelConfig`, `CompactionConfig` configuration models
+- Node implementations: context injection, compaction, react
+- Edge definitions with tool condition routing
+- `ObservabilityHook` lifecycle tracing
+
+#### Phase 2 -- Tools & Storage
+- `ToolRegistry` with capability-based tool filtering
+- `DocumentStore` protocol and `InMemoryDocumentStore` implementation
+- `SkillStore` protocol and `InMemorySkillStore` implementation
+- `AgentStore` protocol and `InMemoryAgentStore` implementation
+- Memory tools: `memory_read`, `memory_write`, `memory_search`
+- Skill tools: filtering, formatting, markdown utilities
+- Agent tools and chart tools
+- Web tools with capability-gated access
+- `MissingCapabilityError` for clear DI failure messages
+
+#### Phase 3 -- Prompt & Streaming
+- `PromptBuilder` with composable, prioritized sections
+- Built-in sections: `ScopeSection`, `MemorySection`, `SkillsSection`, `StaticSection`
+- Stream event types: `TextDeltaEvent`, `MessageEndEvent`, `ExtensionEvent`
+- `process_stream_events` for stream consumption
+- Anthropic and OpenAI streaming adapters
+- `CapabilityError` with structured error codes and metadata
+- External capability contracts (Firecrawl, OpenAI Search)
+- `ContextCollisionError` for context injection conflicts
+
+#### Phase 4 -- Hardening
+- 700 unit and integration tests
+- Contract tests for `DocumentStore`, `SkillStore`, `AgentStore`
+- Mock blindspot audit (41 tests verifying test doubles)
+- Critical path tests across all phases
+- Phase 2 and Phase 3 coverage gap tests
+- Import graph validation (no circular dependencies)
+- Public API surface test
+
+#### Phase 5 -- Documentation & Examples
+- 5 curated examples: `minimal_agent`, `tool_agent`, `skill_agent`,
+  `agent_with_memory`, `e2e_basic_agent`
+- `demo_app` with mock, real, and e2e modes
+- CI example validation test suite (25 tests)
+- API reference generation via pdoc
+- Conceptual documentation: architecture, capabilities, examples learning path
+- Advanced examples directory structure
+- `pyproject.toml` with hatch build and internal PyPI publish config
+- README with installation, quickstart, and API surface overview
+
+### Infrastructure
+- Python 3.11+ with `py.typed` marker for PEP 561
+- Hatchling build backend
+- pytest + pytest-asyncio + pytest-cov test stack
+- ruff linter and mypy strict type checking
+- Internal PyPI at `https://gitea-teotl.amsiops.io/api/packages/AmSiDev/pypi`

symfonic_core-4.9.0/CLAUDE.md

@@ -0,0 +1,159 @@
+<!-- MCM:BEGIN - Auto-generated by mcm init. Edit freely, MCM section preserved on updates. -->
+# symfonic - Claude Instructions
+
+## Core Policies (Quick Reference)
+
+### Code Quality
+- **SOLID principles** - Single Responsibility, Open/Closed, Liskov, Interface Segregation, Dependency Inversion
+- **Max 300 lines per file** - Split larger files into modules
+- **One class per file** - Favor composition over inheritance
+
+### Testing
+- **Prefer TDD when feasible** - test first, then implementation
+- **If tests exist:** add/update tests for changed behavior and run relevant suites
+- **If tests do not exist:** propose minimal test setup and commands
+
+### Output (Memory-First)
+- **Default:** Verbal response + memory entry (importance 6-8)
+- **Create files only when:** User explicitly requests
+- **Code files:** Full implementations to `src/`, `tests/` (never summarize)
+
+### Memory
+- **Personal DB:** `.agent/memory/memory.db` (per-developer, gitignored)
+- **Team Memory:** `.agent/team/*.md` (shared, git-committed)
+- **Never store:** API keys, passwords, credentials, PII
+- **Importance:** 9-10 critical, 7-8 significant, 5-6 context
+
+---
+
+## Auto-Delegation
+
+When requests match these domains, delegate to specialized agents via Task tool.
+
+| Request Contains | Spawn Agent | Example |
+|-----------------|-------------|---------|
+| Docker, CI/CD, containers | `devops-engineer` | "Add Docker config" |
+| Terraform, AWS, IaC | `terraform-engineer` | "Create S3 bucket" |
+| FastAPI, Pydantic | `python-fastapi-pro` | "Add API endpoint" |
+| React, TypeScript | `react-typescript-specialist` | "Create React form" |
+| Flutter, Dart | `flutter-expert` | "Build Flutter screen" |
+| Laravel, PHP | `php-pro` | "Add migration" |
+| pytest, API tests | `api-backend-tester` | "Write API tests" |
+| E2E, Playwright | `api-frontend-tester` | "Add E2E tests" |
+| Architecture | `system-architect` | "Design microservice" |
+
+---
+
+## File Discovery (Token Efficiency)
+
+### 1. Memory Query (Preferred)
+```bash
+mcm query "authentication login" --claude
+```
+
+### 2. Code Structure Search
+```bash
+mcm query "function_name" --tags "code-structure" --claude
+```
+
+### 3. Glob/Grep (For pattern matching)
+```bash
+Glob("**/*.go")
+Grep("func authenticate", type="go")
+```
+
+---
+
+## Memory-First Workflow
+
+**Before starting any task:**
+
+1. **Check auto-injected context** - Use it if relevant
+2. **Query memory** - `mcm query "topic" --claude`
+3. **Targeted reads only** - Read specific lines, not entire files
+4. **Store insights** - Important decisions (importance 7-8)
+
+**Decision Tree:**
+- Looking for past decisions? -> `mcm query "topic" --claude`
+- Looking for code by concept? -> `mcm query --tags "code-structure"`
+- Need to discover files? -> Glob/Grep
+- None work? -> broader exploration
+
+---
+
+## Memory System
+
+- **Personal DB:** `.agent/memory/memory.db` (per-developer, gitignored)
+- **Team Memory:** `.agent/team/*.md` (shared, git-committed)
+- **Hooks:** Auto-injected context via SessionStart, UserPromptSubmit, PreCompact
+
+### Commands
+```bash
+mcm query "search terms" --claude    # Search memory
+mcm store "insight" --importance 7   # Store personal entry
+mcm stats                            # View statistics
+mcm index                            # Index code structure
+```
+
+### Team Memory
+
+Store team-worthy decisions so all developers and agents share context:
+```bash
+mcm team add --type decision --title "Use RS256 JWT" --importance 9 \
+  --tags auth,security "We chose RS256 over HS256 because..."
+mcm team list                        # Show active entries
+mcm team supersede <old-id> --by <new-id>  # Mark as replaced
+```
+
+**Store to TEAM memory (`mcm team add`) when another developer would need this.**
+Choose the type based on what the entry IS, not where you found it:
+
+| Type | When to use | Ask yourself |
+|------|-------------|--------------|
+| `decision` | A choice was made between alternatives | "Why did we pick X over Y?" |
+| `convention` | A pattern or rule the team must follow | "Should everyone do it this way?" |
+| `infrastructure` | A fact about servers, services, or deployment | "Where is X? How do I connect to Y?" |
+| `issue` | A bug, gotcha, or workaround | "Will someone else hit this same problem?" |
+| `api-contract` | An API shape, endpoint, or schema | "What does this endpoint expect/return?" |
+| `plan` | A feature plan or roadmap item | "What are we building and in what order?" |
+
+**Store to PERSONAL memory (`mcm store`) when:**
+- Session-specific debugging notes
+- Local deployment paths and personal workflow
+- Exploration results that may not be final
+- Temporary context for current task
+
+---
+
+## Project-Specific
+
+### Technology Stack
+<!-- List your tech stack -->
+
+### Code Style
+<!-- Describe coding conventions -->
+
+### Architecture Notes
+<!-- Key architectural decisions -->
+
+### Common Tasks
+<!-- Frequent operations -->
+
+---
+
+## Quick Reference
+
+| Need To | Action |
+|---------|--------|
+| Find past decisions | `mcm query "topic" --claude` |
+| Find code by concept | `mcm query --tags "code-structure"` |
+| Find code by pattern | Use Grep tool |
+| Store personal insight | `mcm store "insight" --importance 7` |
+| Store team decision | `mcm team add --type decision --title "..." "body"` |
+| List team knowledge | `mcm team list` |
+| Index codebase | `mcm index` |
+
+---
+
+*Edit this file for your project. Run `mcm index` after setup.*
+<!-- MCM:END -->