sociomemory 0.2.0__tar.gz

sociomemory-0.2.0/.github/workflows/ci.yml

@@ -0,0 +1,36 @@
+name: CI
+
+on:
+  push:
+  pull_request:
+
+jobs:
+  quality:
+    runs-on: ubuntu-latest
+    strategy:
+      matrix:
+        python-version: ["3.11", "3.12"]
+    steps:
+      - uses: actions/checkout@v4
+      - uses: actions/setup-python@v5
+        with:
+          python-version: ${{ matrix.python-version }}
+          cache: pip
+      - run: python -m pip install --upgrade pip
+      - run: python -m pip install -e ".[dev]"
+      - run: ruff check .
+      - run: ruff format --check .
+      - run: mypy sociomemory
+      - run: pytest -m "not integration and not network" --cov=sociomemory --cov-report=term-missing --cov-fail-under=45
+
+  package:
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+      - uses: actions/setup-python@v5
+        with:
+          python-version: "3.11"
+      - run: python -m pip install --upgrade build
+      - run: python -m build
+      - run: python -m pip install dist/*.whl
+      - run: python -c "import sociomemory; print(sociomemory.__version__)"

sociomemory-0.2.0/.gitignore

@@ -0,0 +1,34 @@
+__pycache__/
+*.py[cod]
+*.pyo
+.venv/
+venv/
+node_modules/
+dist/
+build/
+*.egg-info/
+.pytest_cache/
+.coverage
+.ruff_cache/
+*.faiss
+*.map.json
+*.bm25.json
+~/.sociomemory/
+.env
+.env.local
+*.db
+.DS_Store
+*.log
+*.bak
+*.tmp
+*.swp
+*.swo
+.idea/
+.vscode/
+.claude/
+/docs/
+# not part of the pip package
+sociomemory/dashboard/
+tests/test_dashboard_export.py
+CLAUDE.md
+AGENTS.md

sociomemory-0.2.0/CHANGELOG.md

@@ -0,0 +1,49 @@
+# Changelog
+
+All notable changes to `sociomemory` are 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).
+
+## [Unreleased]
+
+## [0.2.0] - 2026-07-08
+
+### Added
+- spaCy entity pre-pass and LLM-typed signal extraction replacing the regex extractor,
+  with graceful degradation when spaCy or an LLM backend is unavailable (`nlp` extra).
+- Consent-scope mappings for housing, dietary, language, transport, family-structure,
+  sensory, lifestyle, and generic signals.
+- `NodeType.CIVIC` as an allowed target of `NEIGHBORHOOD --HAS_CONTEXT-->` in the graph schema.
+- `ECONOMIC --DERIVES--> INCOME` edge in the graph schema.
+- BM25 keyword recall with persistent per-child indexes and FAISS-free fallback behavior.
+- Optional fail-closed consent enforcement and consent-gated full data exports.
+- Python 3.11/3.12 CI for linting, tests, coverage, and wheel installation.
+
+### Changed
+- Split LLM/provider construction and privacy operations out of the public client module.
+- Moved provider SDKs, FAISS, and geospatial dependencies into explicit package extras.
+- Normalized model timestamps to timezone-aware UTC values.
+- Consolidated tests under the top-level `tests/` directory.
+- Removed decorative and implementation-narrating comments from the Python sources.
+
+### Fixed
+- Prevented child identifiers from escaping local index directories.
+- Erasure now evicts in-memory indexes and removes BM25 data in addition to FAISS data.
+- Dynamic Cypher relationship names and traversal depths are validated before interpolation.
+- `enrichment_cache_ttl_hours` is now honored by online providers.
+
+## [0.1.0] - 2026-05-16
+
+Initial alpha release of the graph memory engine for social context inference.
+
+### Added
+- `MemoryGraph` engine with Neo4j-backed graph storage and FAISS vector index.
+- Signal extraction, enrichment, and coaching-implication pipeline
+  (`SignalExtractor`, `EnrichmentPipeline`, `CoachingImplicator`).
+- Domain models: `SocioProfile`, `IncomeEstimate`, `CoachingImplication`, `TradeOff`.
+- Privacy layer: `ConsentManager`, `ConsentScope`, GDPR-style erase/export APIs.
+- LLM provider abstractions for Gemini, OpenAI, and local backends.
+- Online/offline data providers (Exa optional via `online` extra).
+- India-focused reference data: cities, real-estate tiers, school boards, cultural regions, amenity categories.
+- Optional extras: `online` (Exa), `geo` (geopandas/shapely), `dev` (pytest, ruff, testcontainers).

sociomemory-0.2.0/LICENSE

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