skillmind 0.3.2__tar.gz → 0.4.0__tar.gz

{skillmind-0.3.2 → skillmind-0.4.0}/.gitignore

@@ -1,52 +1,56 @@
-# Python
-__pycache__/
-*.py[cod]
-*$py.class
-*.so
-*.egg-info/
-dist/
-build/
-.eggs/
-
-# Virtual environments
-venv/
-.venv/
-env/
-
-# IDE
-.idea/
-.vscode/
-*.swp
-*.swo
-
-# Environment / secrets
-.env
-.env.local
-.env.*.local
-
-# Runtime data
-.skillmind/
-*.db
-*.sqlite3
-
-# Test / coverage
-.pytest_cache/
-.coverage
-htmlcov/
-.mypy_cache/
-
-# OS
-.DS_Store
-Thumbs.db
-desktop.ini
-
-# Recordings (runtime)
-recordings/
-
-# Obsidian vaults (user data, not code)
-test_vault/
-*_vault/
-
-# Website (private repo)
-website/
-generate_pdfs.py
+# Python
+__pycache__/
+*.py[cod]
+*$py.class
+*.so
+*.egg-info/
+dist/
+build/
+.eggs/
+
+# Virtual environments
+venv/
+.venv/
+env/
+
+# IDE
+.idea/
+.vscode/
+*.swp
+*.swo
+
+# Environment / secrets
+.env
+.env.local
+.env.*.local
+
+# Runtime data
+.skillmind/
+*.db
+*.sqlite3
+
+# Test / coverage
+.pytest_cache/
+.coverage
+htmlcov/
+.mypy_cache/
+
+# OS
+.DS_Store
+Thumbs.db
+desktop.ini
+
+# Recordings (runtime)
+recordings/
+
+# Obsidian vaults (user data, not code)
+test_vault/
+*_vault/
+
+# Website (private repo)
+website/
+generate_pdfs.py
+
+# Deploy secrets — public repo: commit the generic guide, never the instance values
+deploy/**/*.local.*
+deploy/**/.railway

{skillmind-0.3.2 → skillmind-0.4.0}/CLAUDE.md

@@ -1,82 +1,82 @@
-# SkillMind
-
-**Active Skill Listener & Trainer** — structured memory layer for AI coding assistants.
-
-## What is this?
-
-SkillMind replaces flat markdown memory files with a vector-database-backed memory system that:
-- **Listens** to git events, file changes, and conversations
-- **Trains** by auto-classifying, deduplicating, and consolidating knowledge
-- **Surfaces** only relevant context per conversation (not everything)
-
-## Architecture
-
-```
-src/skillmind/
-├── models.py          # Memory, QueryFilter, QueryResult (Pydantic)
-├── config.py          # SkillMindConfig (YAML-based)
-├── embeddings.py      # EmbeddingEngine (sentence-transformers | openai)
-├── trainer.py         # Auto-classify, dedup, merge, consolidate
-├── listener.py        # GitListener, FileListener, ConversationListener
-├── context.py         # ContextGenerator — dynamic context for Claude Code
-├── migration.py       # Import existing Claude Code markdown memories
-├── store/
-│   ├── base.py        # Abstract MemoryStore interface
-│   ├── chroma_store.py    # ChromaDB backend (default)
-│   ├── pinecone_store.py  # Pinecone backend
-│   ├── supabase_store.py  # Supabase/pgvector backend
-│   ├── qdrant_store.py    # Qdrant backend
-│   └── faiss_store.py     # FAISS + JSON backend
-├── exporters/
-│   ├── __init__.py
-│   └── obsidian.py    # Obsidian vault exporter (Karpathy wiki pattern)
-├── mcp/
-│   └── server.py      # MCP server (25+ tools for Claude Code)
-└── cli/
-    └── main.py        # CLI (click-based)
-```
-
-## Key Commands
-
-```bash
-pip install -e ".[chroma]"          # Install with Chroma backend
-skillmind init --backend chroma     # Initialize
-skillmind import                    # Import existing Claude Code memories
-skillmind remember "content"        # Store memory
-skillmind recall "query"            # Semantic search
-skillmind list                      # List all
-skillmind consolidate               # Cleanup
-skillmind serve                     # Start MCP server
-skillmind export ~/MyWiki           # Export to Obsidian vault
-skillmind sync                      # Incremental sync to vault
-```
-
-## Store Backends
-
-All 5 implement the same `MemoryStore` interface (add, query, get, update, delete, list_all, count, clear):
-
-| Backend | Best for | Requires |
-|---------|----------|----------|
-| **chroma** | Solo dev, local, default | `pip install chromadb` |
-| **faiss** | Offline, air-gapped, fastest | `pip install faiss-cpu` |
-| **qdrant** | Self-hosted or cloud, great filtering | Qdrant server |
-| **pinecone** | Multi-device cloud sync | API key |
-| **supabase** | SQL + vectors, team sharing | Supabase project |
-
-## MCP Server Tools
-
-10 tools exposed via FastMCP: `remember`, `recall`, `forget`, `update_memory`, `context`, `consolidate`, `memory_stats`, `list_memories`, `import_markdown_memories`.
-
-## Memory Types
-
-- **user** — role, preferences, expertise
-- **feedback** — corrections, confirmed approaches
-- **project** — deadlines, client context, status (auto-expires 90d)
-- **reference** — external URLs, dashboards, wikis
-- **skill** — patterns, workflows, how-tos
-
-## Testing
-
-```bash
-pytest tests/ -v
-```
+# SkillMind
+
+**Active Skill Listener & Trainer** — structured memory layer for AI coding assistants.
+
+## What is this?
+
+SkillMind replaces flat markdown memory files with a vector-database-backed memory system that:
+- **Listens** to git events, file changes, and conversations
+- **Trains** by auto-classifying, deduplicating, and consolidating knowledge
+- **Surfaces** only relevant context per conversation (not everything)
+
+## Architecture
+
+```
+src/skillmind/
+├── models.py          # Memory, QueryFilter, QueryResult (Pydantic)
+├── config.py          # SkillMindConfig (YAML-based)
+├── embeddings.py      # EmbeddingEngine (sentence-transformers | openai)
+├── trainer.py         # Auto-classify, dedup, merge, consolidate
+├── listener.py        # GitListener, FileListener, ConversationListener
+├── context.py         # ContextGenerator — dynamic context for Claude Code
+├── migration.py       # Import existing Claude Code markdown memories
+├── store/
+│   ├── base.py        # Abstract MemoryStore interface
+│   ├── chroma_store.py    # ChromaDB backend (default)
+│   ├── pinecone_store.py  # Pinecone backend
+│   ├── supabase_store.py  # Supabase/pgvector backend
+│   ├── qdrant_store.py    # Qdrant backend
+│   └── faiss_store.py     # FAISS + JSON backend
+├── exporters/
+│   ├── __init__.py
+│   └── obsidian.py    # Obsidian vault exporter (Karpathy wiki pattern)
+├── mcp/
+│   └── server.py      # MCP server (25+ tools for Claude Code)
+└── cli/
+    └── main.py        # CLI (click-based)
+```
+
+## Key Commands
+
+```bash
+pip install -e ".[chroma]"          # Install with Chroma backend
+skillmind init --backend chroma     # Initialize
+skillmind import                    # Import existing Claude Code memories
+skillmind remember "content"        # Store memory
+skillmind recall "query"            # Semantic search
+skillmind list                      # List all
+skillmind consolidate               # Cleanup
+skillmind serve                     # Start MCP server
+skillmind export ~/MyWiki           # Export to Obsidian vault
+skillmind sync                      # Incremental sync to vault
+```
+
+## Store Backends
+
+All 5 implement the same `MemoryStore` interface (add, query, get, update, delete, list_all, count, clear):
+
+| Backend | Best for | Requires |
+|---------|----------|----------|
+| **chroma** | Solo dev, local, default | `pip install chromadb` |
+| **faiss** | Offline, air-gapped, fastest | `pip install faiss-cpu` |
+| **qdrant** | Self-hosted or cloud, great filtering | Qdrant server |
+| **pinecone** | Multi-device cloud sync | API key |
+| **supabase** | SQL + vectors, team sharing | Supabase project |
+
+## MCP Server Tools
+
+10 tools exposed via FastMCP: `remember`, `recall`, `forget`, `update_memory`, `context`, `consolidate`, `memory_stats`, `list_memories`, `import_markdown_memories`.
+
+## Memory Types
+
+- **user** — role, preferences, expertise
+- **feedback** — corrections, confirmed approaches
+- **project** — deadlines, client context, status (auto-expires 90d)
+- **reference** — external URLs, dashboards, wikis
+- **skill** — patterns, workflows, how-tos
+
+## Testing
+
+```bash
+pytest tests/ -v
+```

{skillmind-0.3.2 → skillmind-0.4.0}/LICENSE

@@ -1,21 +1,21 @@
-MIT License
-
-Copyright (c) 2026 Antonio Blago
-
-Permission is hereby granted, free of charge, to any person obtaining a copy
-of this software and associated documentation files (the "Software"), to deal
-in the Software without restriction, including without limitation the rights
-to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
-copies of the Software, and to permit persons to whom the Software is
-furnished to do so, subject to the following conditions:
-
-The above copyright notice and this permission notice shall be included in all
-copies or substantial portions of the Software.
-
-THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
-IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
-FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
-AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
-LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
-OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
-SOFTWARE.
+MIT License
+
+Copyright (c) 2026 Antonio Blago
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

{skillmind-0.3.2 → skillmind-0.4.0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: skillmind
-Version: 0.3.2
+Version: 0.4.0
 Summary: Active Skill Listener & Trainer — structured memory layer for AI coding assistants
 Project-URL: Homepage, https://skill-mind.com
 Project-URL: Documentation, https://skill-mind.com/en/quickstart/
@@ -9,7 +9,7 @@ Project-URL: Issues, https://github.com/AntonioBlago/skillmind/issues
 Author-email: Antonio Blago <info@antonioblago.com>
 License-Expression: MIT
 License-File: LICENSE
-Keywords: ai-assistant,chroma,claude-code,faiss,mcp,memory,pinecone,qdrant,screen-recording,semantic-search,skill-learning,supabase,vector-database,youtube
+Keywords: ai-assistant,chroma,claude-code,faiss,falkordb,graphrag,knowledge-graph,mcp,memory,pinecone,qdrant,screen-recording,semantic-search,skill-learning,supabase,vector-database,youtube
 Classifier: Development Status :: 3 - Alpha
 Classifier: Intended Audience :: Developers
 Classifier: License :: OSI Approved :: MIT License
@@ -29,6 +29,7 @@ Requires-Dist: sentence-transformers>=2.2.0
 Provides-Extra: all
 Requires-Dist: chromadb>=0.4.0; extra == 'all'
 Requires-Dist: faiss-cpu>=1.7; extra == 'all'
+Requires-Dist: falkordb>=1.6; extra == 'all'
 Requires-Dist: fastmcp>=3.2.0; extra == 'all'
 Requires-Dist: mss>=9.0; extra == 'all'
 Requires-Dist: opencv-python>=4.8; extra == 'all'
@@ -48,6 +49,8 @@ Requires-Dist: pytest-asyncio>=0.21; extra == 'dev'
 Requires-Dist: pytest>=7.0; extra == 'dev'
 Provides-Extra: faiss
 Requires-Dist: faiss-cpu>=1.7; extra == 'faiss'
+Provides-Extra: falkordb
+Requires-Dist: falkordb>=1.6; extra == 'falkordb'
 Provides-Extra: mcp
 Requires-Dist: fastmcp>=3.2.0; extra == 'mcp'
 Provides-Extra: pinecone
@@ -455,15 +458,15 @@ SkillMind works great alongside other MCP servers:
 
 | MCP Server | What it adds | Install |
 |---|---|---|
-| **[Visibly AI MCP](https://pypi.org/project/visiblyai-mcp-server/)** | SEO skills: keyword research, backlinks, site audit, GSC queries, on-page analysis | `pip install visiblyai-mcp-server` |
+| **[Visibly AI MCP](https://www.antonioblago.com/de/entwickler/mcp)** | SEO skills: keyword research, backlinks, site audit, GSC queries, on-page analysis | Hosted MCP — no install; add HTTP config to `settings.json` |
 | **[Notion MCP](https://mcp.notion.com/)** | Read/write Notion pages, databases, todos | Built-in |
 | **[Playwright MCP](https://github.com/anthropics/mcp-playwright)** | Browser automation, screenshots, web scraping | Built-in |
 
 ### Example: SEO Memory + Skills
 
 ```bash
-# Install both
-pip install skillmind[pinecone,mcp] visiblyai-mcp-server
+# SkillMind installs locally; Visibly AI is a hosted MCP (no install needed)
+pip install skillmind[pinecone,mcp]
 ```
 
 ```json
@@ -485,6 +488,14 @@ pip install skillmind[pinecone,mcp] visiblyai-mcp-server
 
 SkillMind remembers your SEO preferences, client keywords, and audit findings. Visibly AI provides the live SEO data. Together: persistent SEO intelligence.
 
+## Used by
+
+### [peec-ai-skills](https://github.com/AntonioBlago/peec-ai-skills)
+
+A Claude Code skill repository for **Peec AI** (brand-visibility tracking in LLM search) that uses SkillMind as its **cross-project memory layer**. The `skillmind-learner` skill writes causal, evidence-backed patterns to SkillMind after a Peec AI growth-loop outcome is measured, and recalls matching patterns as priors for the growth-agent orchestrator on the next run — so lessons learned on project A inform decisions on project B.
+
+See [`skills/skillmind-learner/SKILL.md`](https://github.com/AntonioBlago/peec-ai-skills/blob/main/skills/skillmind-learner/SKILL.md) for the full integration contract (read vs. write mode, required tags, pattern schema, handoff points from the other 5 Peec skills).
+
 ## Contributing
 
 PRs welcome! See [CONTRIBUTING.md](CONTRIBUTING.md).