Skip to content

Commit 588a035

Browse files
GeneAIclaude
GeneAI
and
claude
committed
Initial commit: MemDocs v2.0.0
MemDocs is a git-native persistent memory system for AI projects. Features: - Git-native storage (no cloud, no costs) - Claude Sonnet 4.5 integration - Empathy Framework support (Level 4 Anticipatory Intelligence) - Model Context Protocol (MCP) server - File/module/repo scoping with auto-escalation - Token-efficient (summarization only, no embeddings) - Python API and CLI tool - Optional privacy guards (PHI/PII) This is a rebrand and modernization of DocInt 1.0, with improved architecture, documentation, and Empathy integration. 🧠 Generated with Claude Code Co-Authored-By: Claude <[email protected]>
0 parents  commit 588a035

22 files changed

+5546
-0
lines changed

‎.gitignore‎

Lines changed: 74 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,74 @@
1+
# Python
2+
__pycache__/
3+
*.py[cod]
4+
*$py.class
5+
*.so
6+
.Python
7+
build/
8+
develop-eggs/
9+
dist/
10+
downloads/
11+
eggs/
12+
.eggs/
13+
lib/
14+
lib64/
15+
parts/
16+
sdist/
17+
var/
18+
wheels/
19+
pip-wheel-metadata/
20+
share/python-wheels/
21+
*.egg-info/
22+
.installed.cfg
23+
*.egg
24+
MANIFEST
25+
26+
# Virtual environments
27+
venv/
28+
ENV/
29+
env/
30+
.venv
31+
32+
# IDE
33+
.vscode/
34+
.idea/
35+
*.swp
36+
*.swo
37+
*~
38+
.DS_Store
39+
40+
# Testing
41+
.pytest_cache/
42+
.coverage
43+
htmlcov/
44+
.tox/
45+
.hypothesis/
46+
47+
# MyPy
48+
.mypy_cache/
49+
.dmypy.json
50+
dmypy.json
51+
52+
# Ruff
53+
.ruff_cache/
54+
55+
# Environment variables
56+
.env
57+
.env.local
58+
.env.*.local
59+
60+
# MemDocs output (for testing)
61+
.memdocs/
62+
*.memdocs.yml.backup
63+
64+
# Distribution
65+
*.tar.gz
66+
*.whl
67+
68+
# Logs
69+
*.log
70+
71+
# Temporary files
72+
*.tmp
73+
*.temp
74+
.cache/

‎.memdocs.yml.example‎

Lines changed: 57 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,57 @@
1+
version: 2
2+
3+
# Scope policy (controls memory granularity)
4+
policies:
5+
default_scope: file # file | module | repo
6+
max_files_without_force: 150
7+
8+
# Auto-escalate for important changes
9+
escalate_on:
10+
- cross_module_changes # Multi-module = bigger context needed
11+
- security_sensitive_paths # auth/*, security/* = document thoroughly
12+
- public_api_signatures # API changes = team needs to know
13+
14+
# Output configuration (git-committed memory)
15+
outputs:
16+
docs_dir: .memdocs/docs # Committed to git
17+
memory_dir: .memdocs/memory # Committed to git
18+
formats:
19+
- json # index.json (machine-readable)
20+
- yaml # symbols.yaml (code map)
21+
- markdown # summary.md (human-readable)
22+
23+
# Privacy (optional, only enable if handling sensitive data)
24+
privacy:
25+
phi_mode: "off" # off | standard | strict
26+
pii_detection: false
27+
redaction_enabled: false
28+
29+
# AI configuration (Claude API)
30+
ai:
31+
provider: anthropic # anthropic | openai
32+
model: claude-sonnet-4-5-20250929 # Claude Sonnet 4.5 (latest)
33+
max_tokens: 8192
34+
temperature: 0.3 # Lower = more deterministic
35+
36+
# Empathy Framework integration (optional)
37+
empathy:
38+
enabled: true
39+
sync_on_review: true # Auto-sync with Empathy after reviews
40+
level: 4 # Anticipatory Empathy level
41+
42+
# Exclude patterns (don't document these)
43+
exclude:
44+
- node_modules/**
45+
- .venv/**
46+
- venv/**
47+
- __pycache__/**
48+
- "*.pyc"
49+
- .git/**
50+
- dist/**
51+
- build/**
52+
- "*.log"
53+
- "*.db"
54+
- coverage/**
55+
- htmlcov/**
56+
- .pytest_cache/**
57+
- "*.egg-info/**"

‎CHANGELOG.md‎

Lines changed: 98 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,98 @@
1+
# Changelog
2+
3+
All notable changes to MemDocs will be documented in this file.
4+
5+
The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.0.0/),
6+
and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
7+
8+
## [2.0.0] - 2025-11-07
9+
10+
### Added
11+
- **Rebranding**: DocInt → MemDocs (new name, same powerful memory)
12+
- Comprehensive README with examples and use cases
13+
- Empathy Framework integration (Level 4 Anticipatory Intelligence)
14+
- Model Context Protocol (MCP) server support
15+
- Python API for programmatic access
16+
- Example scripts demonstrating all features
17+
- Improved configuration with `.memdocs.yml`
18+
- Token-efficient summarization (no embeddings required)
19+
- Git-native storage architecture
20+
21+
### Changed
22+
- Package name: `docint` → `memdocs`
23+
- Directory structure: `.docint/` → `.memdocs/`
24+
- CLI command: `docint` → `memdocs`
25+
- Updated to Claude Sonnet 4.5 (claude-sonnet-4-5-20250929)
26+
- Improved documentation and examples
27+
- Modernized pyproject.toml configuration
28+
29+
### Improved
30+
- Better scoping policies (file/module/repo levels)
31+
- Auto-escalation for important changes
32+
- Enhanced privacy controls (PHI/PII optional)
33+
- Faster local search (no API calls)
34+
- Cleaner API design
35+
36+
### Migration from DocInt 1.x
37+
If you're upgrading from DocInt 1.x:
38+
39+
1. **Rename directory**: `.docint/` → `.memdocs/`
40+
2. **Update config**: `.docint.yml` → `.memdocs.yml`
41+
3. **Update CLI commands**: `docint` → `memdocs`
42+
4. **Update Python imports**: `from docint import *` → `from memdocs import *`
43+
5. **Re-install package**: `pip uninstall docint && pip install memdocs`
44+
45+
Migration script:
46+
```bash
47+
# Automated migration (run in project root)
48+
mv .docint .memdocs 2>/dev/null || true
49+
mv .docint.yml .memdocs.yml 2>/dev/null || true
50+
sed -i '' 's/docint/memdocs/g' .memdocs.yml
51+
pip uninstall docint -y
52+
pip install memdocs
53+
```
54+
55+
## [1.0.0] - 2025-10-23 (DocInt)
56+
57+
### Added
58+
- Initial release of DocInt
59+
- Git-native memory storage
60+
- Claude API integration
61+
- File/module/repo scoping
62+
- Symbol extraction with tree-sitter
63+
- CLI tool
64+
- Python API
65+
- Basic privacy guards
66+
67+
---
68+
69+
## Upcoming Releases
70+
71+
### [2.1.0] - Q1 2026 (Planned)
72+
- Multi-language support (Go, Rust, Java, C++)
73+
- VSCode extension
74+
- JetBrains plugin
75+
- Automatic PR summary generation
76+
- Improved Empathy sync workflows
77+
78+
### [2.2.0] - Q2 2026 (Planned)
79+
- Optional semantic search with embeddings
80+
- Memory compression (summarize old memories)
81+
- Team analytics dashboard
82+
- Enhanced privacy features (HIPAA/GDPR compliance)
83+
84+
### [3.0.0] - Q3 2026 (Planned)
85+
- MemDocs Cloud (optional hosted version)
86+
- Enterprise features (SSO, audit logs, access control)
87+
- Advanced Empathy integration (Level 5 predictions)
88+
- Real-time collaboration features
89+
90+
---
91+
92+
## Support
93+
94+
For questions, issues, or feature requests:
95+
- **GitHub Issues**: https://github.com/Deep-Study-AI/memdocs/issues
96+
- **Documentation**: https://docs.deepstudyai.com/memdocs
97+
- **Discord**: https://discord.gg/deepstudyai
98+
- **Email**: [email protected]

0 commit comments

Comments
 (0)