kernle 0.1.0__tar.gz

kernle-0.1.0/.env.example

@@ -0,0 +1,28 @@
+# Providers
+OPENAI_API_KEY=
+
+# =============================================================================
+# SUPABASE (2025+ Key System)
+# =============================================================================
+# Find these at: Dashboard > API Keys
+
+# Project URL (e.g., https://xxxxx.supabase.co)
+SUPABASE_URL=
+SUPABASE_PROJECT_ID=
+
+# Legacy Keys - anon is anon/public key
+SUPABASE_ANON_KEY=
+SUPABASE_SERVICE_ROLE_KEY=
+
+# Publishable Key - safe for client-side (browser, mobile)
+# Dashboard > API Keys > Publishable keys > "web" or "mobile"
+# Starts with: sb_publishable_
+SUPABASE_PUBLISHABLE_KEY=
+
+# Secret Key - for backend/Edge Functions only, NEVER expose to clients
+# Dashboard > API Keys > Secret keys > "+ New secret key"
+# Starts with: sb_secret_
+SUPABASE_SECRET_KEY=
+
+# JWT Secret Key - for signing custom JWTs, if applicable
+JWT_SECRET_KEY=

kernle-0.1.0/.gitignore

@@ -0,0 +1,50 @@
+# Python
+__pycache__/
+*.py[cod]
+*$py.class
+*.so
+.Python
+build/
+develop-eggs/
+dist/
+downloads/
+eggs/
+.eggs/
+/lib/
+/lib64/
+parts/
+sdist/
+var/
+wheels/
+*.egg-info/
+.installed.cfg
+*.egg
+
+# Virtual environments
+.venv/
+venv/
+ENV/
+
+# IDE
+.idea/
+.vscode/
+*.swp
+*.swo
+
+# Testing
+.pytest_cache/
+.coverage
+htmlcov/
+
+# Environment
+.env
+.env.local
+*.local
+
+# OS
+.DS_Store
+Thumbs.db
+
+# Kernle local data
+.kernle/
+supabase/.temp/

kernle-0.1.0/.mcp.json

@@ -0,0 +1,8 @@
+{
+  "mcpServers": {
+    "kernle": {
+      "command": "kernle",
+      "args": ["mcp", "--agent", "claude-code"]
+    }
+  }
+}

kernle-0.1.0/CLAUDE.md

@@ -0,0 +1,81 @@
+# Development Guidelines
+
+## Workflow Requirements
+
+### Parallel Work & Delegation
+- Use specialist subagents (Task tool) to delegate work for parallel execution
+- Don't do everything sequentially when tasks can be parallelized
+- Use the Explore agent for codebase discovery to preserve main context
+- Delegate research and investigation to subagents when possible
+
+### Task Management
+- Use TaskCreate/TaskUpdate for any multi-step work (3+ steps)
+- Break complex work into discrete, trackable tasks
+- Update task status as work progresses (pending → in_progress → completed)
+- Use task dependencies (blockedBy) when order matters
+
+### Before Marking Work Complete
+Always run audits using specialist agents before considering work done:
+
+**Security (security-auditor agent):**
+- Input validation and sanitization
+- Authentication/authorization correctness
+- SQL injection, XSS, command injection risks
+- Secrets exposure (no hardcoded credentials, API keys)
+- OWASP Top 10 vulnerabilities
+
+**Test Quality:**
+- Adequate test coverage for changes
+- No tautological tests (tests that can't fail, assert True, mock returns what you assert)
+- Tests actually exercise the code path, not just mocks
+- Edge cases and error conditions covered
+- Integration tests where appropriate
+
+**Code Quality:**
+- Follows existing codebase patterns and conventions
+- No code duplication that should be abstracted
+- Proper error handling with meaningful messages
+- Type hints on public interfaces (Python) / TypeScript types
+- No commented-out code or debug statements left behind
+
+**Architecture (senior-developer agent for significant changes):**
+- Changes follow established patterns (repository pattern, etc.)
+- No circular dependencies introduced
+- Database migrations are safe (reversible, no data loss)
+- API changes are backwards compatible or properly versioned
+- Performance implications considered (N+1 queries, unnecessary loops)
+
+**Documentation:**
+- Public APIs have clear docstrings/comments
+- Breaking changes documented
+- README updated if setup/usage changes
+
+### Planning
+- Use EnterPlanMode for non-trivial implementations
+- Get user sign-off on approach before significant code changes
+- Use AskUserQuestion when requirements are ambiguous
+
+### Git Hygiene
+- Atomic commits with clear messages
+- Don't commit secrets, large binaries, or generated files
+- Verify .gitignore covers sensitive/generated content
+
+## Project Context
+
+### Tech Stack
+- **Backend**: Python, FastAPI, SQLAlchemy, Pydantic
+- **Frontend**: TypeScript, Next.js, React
+- **Testing**: pytest (Python), Jest/Vitest (TypeScript)
+- **Database**: PostgreSQL with Alembic migrations
+
+### Patterns in Use
+- Repository pattern for data access
+- Pydantic models for API request/response validation
+- Service layer for business logic
+
+## Context Management
+
+- Proactively summarize findings before context grows large
+- Delegate exploration to subagents to preserve main context
+- When approaching complex tasks, consider what can be parallelized
+- Use background tasks (run_in_background) for long-running operations

kernle-0.1.0/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Emergent Instruments
+
+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.

kernle-0.1.0/PKG-INFO

@@ -0,0 +1,138 @@
+Metadata-Version: 2.4
+Name: kernle
+Version: 0.1.0
+Summary: Stratified memory for synthetic intelligences
+Project-URL: Homepage, https://kernle.ai
+Project-URL: Documentation, https://docs.kernle.ai
+Project-URL: Repository, https://github.com/Emergent-Instruments/kernle
+Project-URL: Issues, https://github.com/Emergent-Instruments/kernle/issues
+Author-email: Emergent Instruments <hello@emergentinstruments.com>, Claire <claire@emergentinstruments.com>
+License-Expression: MIT
+License-File: LICENSE
+Keywords: agents,ai,claude,llm,mcp,memory,synthetic-intelligence
+Classifier: Development Status :: 3 - Alpha
+Classifier: Intended Audience :: Developers
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.10
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Topic :: Scientific/Engineering :: Artificial Intelligence
+Requires-Python: >=3.10
+Requires-Dist: python-dotenv>=1.0.0
+Requires-Dist: sqlite-vec>=0.1.0
+Provides-Extra: all
+Requires-Dist: mcp>=1.0.0; extra == 'all'
+Requires-Dist: sqlite-vec>=0.1.0; extra == 'all'
+Requires-Dist: supabase>=2.0.0; extra == 'all'
+Provides-Extra: cloud
+Requires-Dist: supabase>=2.0.0; extra == 'cloud'
+Provides-Extra: dev
+Requires-Dist: black>=23.0; extra == 'dev'
+Requires-Dist: pytest-asyncio>=0.21; extra == 'dev'
+Requires-Dist: pytest-cov>=4.0; extra == 'dev'
+Requires-Dist: pytest>=7.0; extra == 'dev'
+Requires-Dist: ruff>=0.1; extra == 'dev'
+Provides-Extra: local
+Requires-Dist: sqlite-vec>=0.1.0; extra == 'local'
+Provides-Extra: mcp
+Requires-Dist: mcp>=1.0.0; extra == 'mcp'
+Description-Content-Type: text/markdown
+
+# Kernle
+
+**Stratified memory for synthetic intelligences.**
+
+Kernle gives AI agents persistent memory, emotional awareness, and identity continuity. It's the cognitive infrastructure for agents that grow, adapt, and remember who they are.
+
+📚 **Full Documentation: [docs.kernle.ai](https://docs.kernle.ai)**
+
+---
+
+## Quick Start
+
+```bash
+# Install
+pip install kernle
+
+# Initialize your agent
+kernle -a my-agent init
+
+# Load memory at session start
+kernle -a my-agent load
+
+# Check health
+kernle -a my-agent anxiety -b
+
+# Capture experiences
+kernle -a my-agent episode "Deployed v2" "success" --lesson "Always run migrations first"
+kernle -a my-agent raw "Quick thought to process later"
+
+# Save before ending
+kernle -a my-agent checkpoint save "End of session"
+```
+
+## Integration
+
+**Claude Code / CLAUDE.md:**
+```bash
+kernle -a my-agent init  # Generates CLAUDE.md section
+```
+
+**MCP Server:**
+```bash
+claude mcp add kernle -- kernle mcp -a my-agent
+```
+
+**Clawdbot:**
+```bash
+ln -s ~/kernle/skill ~/.clawdbot/skills/kernle
+```
+
+## Features
+
+- 🧠 **Stratified Memory** — Values → Beliefs → Goals → Episodes → Notes
+- 💭 **Psychology** — Drives, emotions, anxiety tracking, identity synthesis
+- 🔗 **Relationships** — Social graphs with trust and interaction history
+- 📚 **Playbooks** — Procedural memory with mastery tracking
+- 🏠 **Local-First** — Works offline, syncs to cloud when connected
+- 🔍 **Readable** — `kernle dump` exports everything as markdown
+
+## Documentation
+
+| Resource | URL |
+|----------|-----|
+| Full Docs | [docs.kernle.ai](https://docs.kernle.ai) |
+| Quickstart | [docs.kernle.ai/quickstart](https://docs.kernle.ai/quickstart) |
+| CLI Reference | [docs.kernle.ai/cli/overview](https://docs.kernle.ai/cli/overview) |
+| API Reference | [docs.kernle.ai/api-reference](https://docs.kernle.ai/api-reference) |
+
+## Development
+
+```bash
+# Clone
+git clone https://github.com/emergent-instruments/kernle
+cd kernle
+
+# Install with dev deps
+uv sync --all-extras
+
+# Run tests
+uv run pytest tests/ -q
+
+# Dev notes
+cat dev/README.md
+```
+
+## Status
+
+- **Tests:** 771 passing
+- **Coverage:** 57%
+- **Backend:** Railway + Supabase
+- **Docs:** Mintlify
+
+See [ROADMAP.md](ROADMAP.md) for development plans.
+
+## License
+
+MIT

kernle-0.1.0/README.md

@@ -0,0 +1,97 @@
+# Kernle
+
+**Stratified memory for synthetic intelligences.**
+
+Kernle gives AI agents persistent memory, emotional awareness, and identity continuity. It's the cognitive infrastructure for agents that grow, adapt, and remember who they are.
+
+📚 **Full Documentation: [docs.kernle.ai](https://docs.kernle.ai)**
+
+---
+
+## Quick Start
+
+```bash
+# Install
+pip install kernle
+
+# Initialize your agent
+kernle -a my-agent init
+
+# Load memory at session start
+kernle -a my-agent load
+
+# Check health
+kernle -a my-agent anxiety -b
+
+# Capture experiences
+kernle -a my-agent episode "Deployed v2" "success" --lesson "Always run migrations first"
+kernle -a my-agent raw "Quick thought to process later"
+
+# Save before ending
+kernle -a my-agent checkpoint save "End of session"
+```
+
+## Integration
+
+**Claude Code / CLAUDE.md:**
+```bash
+kernle -a my-agent init  # Generates CLAUDE.md section
+```
+
+**MCP Server:**
+```bash
+claude mcp add kernle -- kernle mcp -a my-agent
+```
+
+**Clawdbot:**
+```bash
+ln -s ~/kernle/skill ~/.clawdbot/skills/kernle
+```
+
+## Features
+
+- 🧠 **Stratified Memory** — Values → Beliefs → Goals → Episodes → Notes
+- 💭 **Psychology** — Drives, emotions, anxiety tracking, identity synthesis
+- 🔗 **Relationships** — Social graphs with trust and interaction history
+- 📚 **Playbooks** — Procedural memory with mastery tracking
+- 🏠 **Local-First** — Works offline, syncs to cloud when connected
+- 🔍 **Readable** — `kernle dump` exports everything as markdown
+
+## Documentation
+
+| Resource | URL |
+|----------|-----|
+| Full Docs | [docs.kernle.ai](https://docs.kernle.ai) |
+| Quickstart | [docs.kernle.ai/quickstart](https://docs.kernle.ai/quickstart) |
+| CLI Reference | [docs.kernle.ai/cli/overview](https://docs.kernle.ai/cli/overview) |
+| API Reference | [docs.kernle.ai/api-reference](https://docs.kernle.ai/api-reference) |
+
+## Development
+
+```bash
+# Clone
+git clone https://github.com/emergent-instruments/kernle
+cd kernle
+
+# Install with dev deps
+uv sync --all-extras
+
+# Run tests
+uv run pytest tests/ -q
+
+# Dev notes
+cat dev/README.md
+```
+
+## Status
+
+- **Tests:** 771 passing
+- **Coverage:** 57%
+- **Backend:** Railway + Supabase
+- **Docs:** Mintlify
+
+See [ROADMAP.md](ROADMAP.md) for development plans.
+
+## License
+
+MIT