ocerebro 0.1.0

package/package.json

@@ -0,0 +1,49 @@
+{
+  "name": "ocerebro",
+  "version": "0.1.0",
+  "description": "OCerebro - Sistema de Memoria para Agentes (Claude Code/MCP)",
+  "main": "bin/ocerebro.js",
+  "bin": {
+    "ocerebro": "bin/ocerebro.js"
+  },
+  "scripts": {
+    "test": "echo \"Run Python tests with: pytest\" && exit 0"
+  },
+  "keywords": [
+    "claude",
+    "claude-code",
+    "memory",
+    "ai",
+    "agent",
+    "mcp"
+  ],
+  "author": "OARANHA",
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/OARANHA/ocerebro.git"
+  },
+  "homepage": "https://github.com/OARANHA/ocerebro#readme",
+  "bugs": {
+    "url": "https://github.com/OARANHA/ocerebro/issues"
+  },
+  "engines": {
+    "node": ">=16.0.0"
+  },
+  "files": [
+    "bin/",
+    "src/",
+    "cerebro/",
+    "hooks/",
+    "pyproject.toml",
+    "README.md",
+    "LICENSE",
+    "!**/__pycache__/**",
+    "!**/*.pyc",
+    "!**/*.pyo",
+    "!cerebro/config.yaml"
+  ],
+  "publishConfig": {
+    "access": "public"
+  }
+}

package/pyproject.toml

@@ -0,0 +1,77 @@
+[build-system]
+requires = ["setuptools>=61.0", "wheel"]
+build-backend = "setuptools.build_meta"
+
+[project]
+name = "ocerebro"
+version = "0.1.0"
+description = "OCerebro - Sistema de Memoria para Agentes (Claude Code/MCP)"
+readme = "README.md"
+requires-python = ">=3.10"
+authors = [
+    {name = "OARANHA", email = "seu-aranha.com@gmail.com"}
+]
+keywords = [
+    "claude",
+    "claude-code",
+    "memory",
+    "ai",
+    "agent",
+    "mcp",
+    "sqlite",
+    "sqlite-vec",
+]
+classifiers = [
+    "Development Status :: 3 - Alpha",
+    "Intended Audience :: Developers",
+    "License :: OSI Approved :: MIT License",
+    "Programming Language :: Python :: 3",
+    "Programming Language :: Python :: 3.10",
+    "Programming Language :: Python :: 3.11",
+    "Programming Language :: Python :: 3.12",
+]
+dependencies = [
+    "pyyaml>=6.0",
+    "pydantic>=2.0",
+    "sqlite-vec>=0.1.0",
+    "sentence-transformers>=2.2.0",
+    "mcp>=1.0.0",
+    "anthropic>=0.40.0",
+]
+
+[project.optional-dependencies]
+test = [
+    "pytest>=7.0",
+    "pytest-cov>=4.0",
+]
+dev = [
+    "ocerebro[test]",
+    "black>=23.0",
+    "ruff>=0.1.0",
+]
+
+[project.urls]
+Homepage = "https://github.com/OARANHA/ocerebro"
+Repository = "https://github.com/OARANHA/ocerebro.git"
+Documentation = "https://github.com/OARANHA/ocerebro#readme"
+
+[project.scripts]
+ocerebro = "src.cli.main:main"
+ocerebro-setup = "cerebro.cerebro_setup:main"
+
+[tool.setuptools.packages.find]
+where = ["."]
+include = ["src*", "cerebro*"]
+
+[tool.pytest.ini_options]
+testpaths = ["tests"]
+python_files = "test_*.py"
+addopts = "-v --tb=short"
+
+[tool.ruff]
+line-length = 100
+target-version = "py310"
+
+[tool.ruff.lint]
+select = ["E", "F", "W", "I"]
+ignore = ["E501"]

package/src/__init__.py

@@ -0,0 +1,2 @@
+"""Cerebro - Sistema de Memória para Agentes de Código"""
+__version__ = "0.1.0"

package/src/cli/__init__.py

@@ -0,0 +1,2 @@
+"""CLI do Cerebro"""
+__version__ = "0.1.0"

package/src/cli/dream.py

@@ -0,0 +1,91 @@
+"""Comando cerebro dream - Extração automática de memórias.
+
+Replica o comando extractMemories do Claude Code (bloqueado por tengu_passport_quail=false).
+
+Uso:
+    cerebro dream                 # Extrai memórias dos últimos 7 dias (dry-run)
+    cerebro dream --since 14      # Extrai memórias dos últimos 14 dias
+    cerebro dream --apply         # Aplica extração diretamente
+"""
+
+import argparse
+from pathlib import Path
+from typing import Optional
+
+from src.core.paths import get_auto_mem_path
+from src.consolidation.dream import run_dream, generate_dream_report
+
+
+def cmd_dream(
+    project_root: Optional[Path] = None,
+    since_days: int = 7,
+    dry_run: bool = True
+) -> str:
+    """
+    Executa extração automática de memórias (dream).
+
+    Args:
+        project_root: Raiz do projeto (default: git root)
+        since_days: Dias para analisar (default: 7)
+        dry_run: Se True, apenas simula, não modifica nada
+
+    Returns:
+        Relatório da extração
+    """
+    # Resolve memory_dir
+    memory_dir = get_auto_mem_path(project_root)
+
+    # Executa dream
+    result = run_dream(
+        memory_dir=memory_dir,
+        since_days=since_days,
+        dry_run=dry_run
+    )
+
+    # Gera relatório
+    return generate_dream_report(result)
+
+
+def main():
+    """Entry point do comando dream"""
+    parser = argparse.ArgumentParser(
+        prog="cerebro dream",
+        description="Extração automática de memórias (replica extractMemories do Claude Code)"
+    )
+
+    parser.add_argument(
+        "--since",
+        type=int,
+        default=7,
+        dest="since_days",
+        help="Dias para analisar (padrão: 7)"
+    )
+
+    parser.add_argument(
+        "--apply",
+        action="store_true",
+        dest="apply",
+        help="Aplicar extração (padrão: dry-run)"
+    )
+
+    parser.add_argument(
+        "--project",
+        type=Path,
+        default=None,
+        dest="project_root",
+        help="Raiz do projeto (padrão: git root)"
+    )
+
+    args = parser.parse_args()
+
+    result = cmd_dream(
+        project_root=args.project_root,
+        since_days=args.since_days,
+        dry_run=not args.apply
+    )
+
+    print(result)
+
+
+if __name__ == "__main__":
+    main()

package/src/cli/gc.py

@@ -0,0 +1,93 @@
+"""Comando cerebro gc - Garbage collection de memórias.
+
+Replica a lógica de garbage collection do Claude Code baseada em mtime.
+
+Uso:
+    cerebro gc                      # Lista candidatas (dry-run)
+    cerebro gc --threshold 14       # Threshold de 14 dias
+    cerebro gc --apply              # Aplica GC diretamente
+"""
+
+import argparse
+from pathlib import Path
+from typing import Optional
+
+from src.core.paths import get_auto_mem_path
+from src.forgetting.gc import GarbageCollector
+
+
+def cmd_gc(
+    project_root: Optional[Path] = None,
+    threshold_days: int = 7,
+    dry_run: bool = True
+) -> str:
+    """
+    Executa garbage collection de memórias.
+
+    Args:
+        project_root: Raiz do projeto (default: git root)
+        threshold_days: Dias para considerar memória stale (default: 7)
+        dry_run: Se True, apenas lista candidatas, não remove
+
+    Returns:
+        Relatório do GC
+    """
+    # Resolve memory_dir
+    memory_dir = get_auto_mem_path(project_root)
+
+    # Executa GC
+    gc = GarbageCollector(memory_dir)
+    results = gc.run_gc(
+        memory_dir=memory_dir,
+        archive_threshold_days=threshold_days,
+        deletion_threshold_days=threshold_days * 4,  # 4x para deleção
+        dry_run=dry_run
+    )
+
+    # Gera relatório
+    return gc.generate_gc_report(results)
+
+
+def main():
+    """Entry point do comando gc"""
+    parser = argparse.ArgumentParser(
+        prog="cerebro gc",
+        description="Garbage collection de memórias"
+    )
+
+    parser.add_argument(
+        "--threshold",
+        type=int,
+        default=7,
+        dest="threshold_days",
+        help="Dias para considerar memória stale (padrão: 7)"
+    )
+
+    parser.add_argument(
+        "--apply",
+        action="store_true",
+        dest="apply",
+        help="Aplicar GC (padrão: dry-run)"
+    )
+
+    parser.add_argument(
+        "--project",
+        type=Path,
+        default=None,
+        dest="project_root",
+        help="Raiz do projeto (padrão: git root)"
+    )
+
+    args = parser.parse_args()
+
+    result = cmd_gc(
+        project_root=args.project_root,
+        threshold_days=args.threshold_days,
+        dry_run=not args.apply
+    )
+
+    print(result)
+
+
+if __name__ == "__main__":
+    main()