people-context 0.1.1__tar.gz

people_context-0.1.1/.claude-plugin/marketplace.json

@@ -0,0 +1,36 @@
+{
+  "name": "people-context-plugins",
+  "owner": {
+    "name": "Jinyang Wang"
+  },
+  "description": "Local-first Claude Code integrations for people-context-mcp.",
+  "plugins": [
+    {
+      "name": "people-context",
+      "displayName": "People Context",
+      "version": "0.1.0",
+      "source": ".",
+      "description": "Give Claude Code local, durable context about the people in your life through an automatically managed stdio MCP server.",
+      "author": {
+        "name": "Jinyang Wang"
+      },
+      "homepage": "https://github.com/JinyangWang27/people-context/blob/main/docs/claude-code-plugin.md",
+      "repository": "https://github.com/JinyangWang27/people-context",
+      "license": "MIT",
+      "keywords": [
+        "mcp",
+        "people",
+        "context",
+        "memory",
+        "local-first"
+      ],
+      "category": "productivity",
+      "tags": [
+        "mcp",
+        "personal-knowledge",
+        "local-first"
+      ],
+      "strict": true
+    }
+  ]
+}

people_context-0.1.1/.claude-plugin/mcp.json

@@ -0,0 +1,14 @@
+{
+  "mcpServers": {
+    "people-context": {
+      "type": "stdio",
+      "command": "uv",
+      "args": [
+        "run",
+        "--project",
+        "${CLAUDE_PLUGIN_ROOT}",
+        "people-context-mcp"
+      ]
+    }
+  }
+}

people_context-0.1.1/.claude-plugin/plugin.json

@@ -0,0 +1,22 @@
+{
+  "$schema": "https://json.schemastore.org/claude-code-plugin-manifest.json",
+  "name": "people-context",
+  "displayName": "People Context",
+  "version": "0.1.0",
+  "description": "Give Claude Code local, durable context about the people in your life through people-context-mcp.",
+  "author": {
+    "name": "Jinyang Wang",
+    "url": "https://github.com/JinyangWang27"
+  },
+  "homepage": "https://github.com/JinyangWang27/people-context/blob/main/docs/claude-code-plugin.md",
+  "repository": "https://github.com/JinyangWang27/people-context",
+  "license": "MIT",
+  "keywords": [
+    "mcp",
+    "people",
+    "context",
+    "memory",
+    "local-first"
+  ],
+  "mcpServers": "./mcp.json"
+}

people_context-0.1.1/.codegraph/.gitignore

@@ -0,0 +1,5 @@
+# CodeGraph data files — local to each machine, not for committing.
+# Ignore everything in .codegraph/ except this file itself, so transient
+# files (the database, daemon.pid, sockets, logs) never show up in git.
+*
+!.gitignore

people_context-0.1.1/.codegraph/config.json

@@ -0,0 +1,143 @@
+{
+  "version": 1,
+  "include": [
+    "**/*.ts",
+    "**/*.tsx",
+    "**/*.js",
+    "**/*.jsx",
+    "**/*.py",
+    "**/*.go",
+    "**/*.rs",
+    "**/*.java",
+    "**/*.c",
+    "**/*.h",
+    "**/*.cpp",
+    "**/*.hpp",
+    "**/*.cc",
+    "**/*.cxx",
+    "**/*.cs",
+    "**/*.php",
+    "**/*.rb",
+    "**/*.swift",
+    "**/*.kt",
+    "**/*.kts",
+    "**/*.dart",
+    "**/*.svelte",
+    "**/*.vue",
+    "**/*.liquid",
+    "**/*.pas",
+    "**/*.dpr",
+    "**/*.dpk",
+    "**/*.lpr",
+    "**/*.dfm",
+    "**/*.fmx",
+    "**/*.scala",
+    "**/*.sc"
+  ],
+  "exclude": [
+    "**/.git/**",
+    "**/node_modules/**",
+    "**/vendor/**",
+    "**/Pods/**",
+    "**/dist/**",
+    "**/build/**",
+    "**/out/**",
+    "**/bin/**",
+    "**/obj/**",
+    "**/target/**",
+    "**/*.min.js",
+    "**/*.bundle.js",
+    "**/.next/**",
+    "**/.nuxt/**",
+    "**/.svelte-kit/**",
+    "**/.output/**",
+    "**/.turbo/**",
+    "**/.cache/**",
+    "**/.parcel-cache/**",
+    "**/.vite/**",
+    "**/.astro/**",
+    "**/.docusaurus/**",
+    "**/.gatsby/**",
+    "**/.webpack/**",
+    "**/.nx/**",
+    "**/.yarn/cache/**",
+    "**/.pnpm-store/**",
+    "**/storybook-static/**",
+    "**/.expo/**",
+    "**/web-build/**",
+    "**/ios/Pods/**",
+    "**/ios/build/**",
+    "**/android/build/**",
+    "**/android/.gradle/**",
+    "**/__pycache__/**",
+    "**/.venv/**",
+    "**/venv/**",
+    "**/site-packages/**",
+    "**/dist-packages/**",
+    "**/.pytest_cache/**",
+    "**/.mypy_cache/**",
+    "**/.ruff_cache/**",
+    "**/.tox/**",
+    "**/.nox/**",
+    "**/*.egg-info/**",
+    "**/.eggs/**",
+    "**/go/pkg/mod/**",
+    "**/target/debug/**",
+    "**/target/release/**",
+    "**/.gradle/**",
+    "**/.m2/**",
+    "**/generated-sources/**",
+    "**/.kotlin/**",
+    "**/.dart_tool/**",
+    "**/.vs/**",
+    "**/.nuget/**",
+    "**/artifacts/**",
+    "**/publish/**",
+    "**/cmake-build-*/**",
+    "**/CMakeFiles/**",
+    "**/bazel-*/**",
+    "**/vcpkg_installed/**",
+    "**/.conan/**",
+    "**/Debug/**",
+    "**/Release/**",
+    "**/x64/**",
+    "**/.pio/**",
+    "**/release/**",
+    "**/*.app/**",
+    "**/*.asar",
+    "**/DerivedData/**",
+    "**/.build/**",
+    "**/.swiftpm/**",
+    "**/xcuserdata/**",
+    "**/Carthage/Build/**",
+    "**/SourcePackages/**",
+    "**/__history/**",
+    "**/__recovery/**",
+    "**/*.dcu",
+    "**/.composer/**",
+    "**/storage/framework/**",
+    "**/bootstrap/cache/**",
+    "**/.bundle/**",
+    "**/tmp/cache/**",
+    "**/public/assets/**",
+    "**/public/packs/**",
+    "**/.yardoc/**",
+    "**/coverage/**",
+    "**/htmlcov/**",
+    "**/.nyc_output/**",
+    "**/test-results/**",
+    "**/.coverage/**",
+    "**/.idea/**",
+    "**/logs/**",
+    "**/tmp/**",
+    "**/temp/**",
+    "**/_build/**",
+    "**/docs/_build/**",
+    "**/site/**"
+  ],
+  "languages": [],
+  "frameworks": [],
+  "maxFileSize": 1048576,
+  "extractDocstrings": true,
+  "trackCallSites": true
+}

people_context-0.1.1/.github/dependabot.yml

@@ -0,0 +1,41 @@
+version: 2
+
+updates:
+  - package-ecosystem: "uv"
+    directory: "/"
+    schedule:
+      interval: "weekly"
+      day: "monday"
+      time: "04:00"
+      timezone: "Asia/Dubai"
+    open-pull-requests-limit: 5
+    groups:
+      python-dependencies:
+        patterns:
+          - "*"
+
+  - package-ecosystem: "npm"
+    directory: "/openclaw-plugin"
+    schedule:
+      interval: "weekly"
+      day: "monday"
+      time: "04:15"
+      timezone: "Asia/Dubai"
+    open-pull-requests-limit: 5
+    groups:
+      openclaw-plugin-dependencies:
+        patterns:
+          - "*"
+
+  - package-ecosystem: "github-actions"
+    directory: "/"
+    schedule:
+      interval: "weekly"
+      day: "monday"
+      time: "04:30"
+      timezone: "Asia/Dubai"
+    open-pull-requests-limit: 5
+    groups:
+      github-actions:
+        patterns:
+          - "*"

people_context-0.1.1/.github/workflows/ci.yml

@@ -0,0 +1,51 @@
+name: CI
+
+on:
+  pull_request:
+  push:
+    branches:
+      - main
+
+permissions:
+  contents: read
+
+jobs:
+  test:
+    runs-on: ubuntu-latest
+    permissions:
+      contents: read
+      id-token: write
+    steps:
+      - name: Checkout repository
+        uses: actions/checkout@9c091bb21b7c1c1d1991bb908d89e4e9dddfe3e0 # v7.0.0
+        with:
+          persist-credentials: false
+
+      - name: Install uv
+        uses: astral-sh/setup-uv@11f9893b081a58869d3b5fccaea48c9e9e46f990 # v8.3.2
+
+      - name: Install dependencies
+        run: uv sync --locked --all-extras
+
+      - name: Run Ruff
+        run: uv run --locked ruff check .
+
+      - name: Verify package distributions
+        run: |
+          uv lock --check
+          uv build
+          (cd compat/people-context-mcp && uv build --out-dir "$GITHUB_WORKSPACE/dist-legacy")
+          uvx --from twine==6.2.0 twine check dist/* dist-legacy/*
+
+      - name: Run tests with coverage
+        run: uv run --locked --with pytest-cov==7.1.0 pytest --cov=people_context --cov-report=xml -q
+
+      - name: Upload coverage to Codecov
+        if: >-
+          github.actor != 'dependabot[bot]' &&
+          (github.event_name != 'pull_request' || github.event.pull_request.head.repo.full_name == github.repository)
+        uses: codecov/codecov-action@fb8b3582c8e4def4969c97caa2f19720cb33a72f # v7.0.0
+        with:
+          files: ./coverage.xml
+          fail_ci_if_error: false
+          use_oidc: true

people_context-0.1.1/.github/workflows/claude-plugin-validate.yml

@@ -0,0 +1,61 @@
+name: Validate Claude Code plugin
+
+on:
+  pull_request:
+    paths:
+      - ".claude-plugin/**"
+      - "docs/claude-code-plugin.md"
+      - ".github/workflows/claude-plugin-validate.yml"
+      - "pyproject.toml"
+      - "uv.lock"
+      - "src/**"
+      - "tests/adapters/test_mcp_server.py"
+      - "tests/adapters/test_email_import.py"
+  push:
+    branches:
+      - main
+    paths:
+      - ".claude-plugin/**"
+      - "docs/claude-code-plugin.md"
+      - ".github/workflows/claude-plugin-validate.yml"
+      - "pyproject.toml"
+      - "uv.lock"
+      - "src/**"
+      - "tests/adapters/test_mcp_server.py"
+      - "tests/adapters/test_email_import.py"
+
+permissions: read-all
+
+jobs:
+  validate:
+    runs-on: ubuntu-latest
+
+    steps:
+      - name: Checkout repository
+        uses: actions/checkout@9c091bb21b7c1c1d1991bb908d89e4e9dddfe3e0 # v7.0.0
+        with:
+          persist-credentials: false
+
+      - name: Set up Node.js
+        uses: actions/setup-node@820762786026740c76f36085b0efc47a31fe5020 # v7.0.0
+        with:
+          node-version: "22"
+          package-manager-cache: false
+
+      - name: Install Claude Code
+        run: npm install --global @anthropic-ai/claude-code@2.1.214
+
+      - name: Validate marketplace and plugin
+        run: claude plugin validate . --strict
+
+      - name: Install uv
+        uses: astral-sh/setup-uv@11f9893b081a58869d3b5fccaea48c9e9e46f990 # v8.3.2
+
+      - name: Verify local MCP entry point
+        run: uv run --locked people-context-mcp --help
+
+      - name: Verify security boundaries
+        run: >-
+          uv run --locked pytest -q
+          tests/adapters/test_mcp_server.py
+          tests/adapters/test_email_import.py

people_context-0.1.1/.github/workflows/package-publish.yml

@@ -0,0 +1,76 @@
+name: Publish OpenClaw plugin
+
+on:
+  pull_request:
+    paths:
+      - "openclaw-plugin/**"
+      - ".github/workflows/package-publish.yml"
+  workflow_dispatch:
+
+permissions: read-all
+
+jobs:
+  verify-dist:
+    if: github.event_name == 'pull_request'
+    runs-on: ubuntu-latest
+    permissions:
+      contents: read
+    defaults:
+      run:
+        working-directory: ./openclaw-plugin
+    steps:
+      - name: Checkout repository
+        uses: actions/checkout@9c091bb21b7c1c1d1991bb908d89e4e9dddfe3e0 # v7.0.0
+        with:
+          persist-credentials: false
+
+      - name: Set up Node.js
+        uses: actions/setup-node@820762786026740c76f36085b0efc47a31fe5020 # v7.0.0
+        with:
+          node-version: "22"
+          package-manager-cache: false
+
+      - name: Install dependencies
+        run: npm ci --no-audit --no-fund
+
+      - name: Rebuild dist
+        run: npm run build
+
+      - name: Fail if committed dist is stale
+        run: |
+          if ! git diff --quiet -- dist; then
+            echo "::error::Committed openclaw-plugin/dist is out of sync with src. Run 'npm run build' and commit the result."
+            git --no-pager diff --stat -- dist
+            exit 1
+          fi
+
+      - name: Run plugin tests
+        run: npm test
+
+  dry-run:
+    if: github.event_name == 'pull_request'
+    permissions:
+      actions: read
+      contents: read
+      id-token: write
+    # Pinned to the v0.12.0 commit SHA (mutable tags can be re-pointed at malicious code).
+    uses: openclaw/clawhub/.github/workflows/package-publish.yml@a230d962db64019462c2c8ee400755eb92169908
+    with:
+      source: ./openclaw-plugin
+      owner: jinyangwang27
+      dry_run: true
+
+  publish:
+    if: github.event_name == 'workflow_dispatch'
+    permissions:
+      actions: read
+      contents: read
+      id-token: write
+    # Pinned to the v0.12.0 commit SHA (mutable tags can be re-pointed at malicious code).
+    uses: openclaw/clawhub/.github/workflows/package-publish.yml@a230d962db64019462c2c8ee400755eb92169908
+    with:
+      source: ./openclaw-plugin
+      owner: jinyangwang27
+      dry_run: false
+    secrets:
+      clawhub_token: ${{ secrets.CLAWHUB_TOKEN }}

people_context-0.1.1/.github/workflows/release.yml

@@ -0,0 +1,91 @@
+name: Publish to PyPI
+
+on:
+  release:
+    types:
+      - published
+
+permissions: read-all
+
+jobs:
+  build:
+    name: Build distributions
+    runs-on: ubuntu-latest
+    steps:
+      - name: Checkout repository
+        uses: actions/checkout@9c091bb21b7c1c1d1991bb908d89e4e9dddfe3e0 # v7.0.0
+        with:
+          persist-credentials: false
+
+      - name: Install uv
+        uses: astral-sh/setup-uv@11f9893b081a58869d3b5fccaea48c9e9e46f990 # v8.3.2
+
+      - name: Verify lockfile
+        run: uv lock --check
+
+      - name: Build primary distribution
+        run: uv build
+
+      - name: Build legacy compatibility distribution
+        run: |
+          cd compat/people-context-mcp
+          uv build --out-dir "$GITHUB_WORKSPACE/dist-legacy"
+
+      - name: Verify distribution metadata
+        run: uvx --from twine==6.2.0 twine check dist/* dist-legacy/*
+
+      - name: Store primary distributions
+        uses: actions/upload-artifact@043fb46d1a93c77aae656e7c1c64a875d1fc6a0a # v7.0.1
+        with:
+          name: python-package-distributions
+          path: dist/
+          if-no-files-found: error
+
+      - name: Store legacy compatibility distributions
+        uses: actions/upload-artifact@043fb46d1a93c77aae656e7c1c64a875d1fc6a0a # v7.0.1
+        with:
+          name: python-legacy-compat-distributions
+          path: dist-legacy/
+          if-no-files-found: error
+
+  publish:
+    name: Publish people-context
+    needs: build
+    runs-on: ubuntu-latest
+    environment:
+      name: pypi
+      url: https://pypi.org/p/people-context
+    permissions:
+      contents: read
+      id-token: write
+    steps:
+      - name: Download primary distributions
+        uses: actions/download-artifact@3e5f45b2cfb9172054b4087a40e8e0b5a5461e7c # v8.0.1
+        with:
+          name: python-package-distributions
+          path: dist/
+
+      - name: Publish primary distribution
+        uses: pypa/gh-action-pypi-publish@cef221092ed1bacb1cc03d23a2d87d1d172e277b # v1.14.0
+
+  publish-legacy:
+    name: Publish people-context-mcp compatibility package
+    needs: build
+    runs-on: ubuntu-latest
+    environment:
+      name: pypi
+      url: https://pypi.org/p/people-context-mcp
+    permissions:
+      contents: read
+      id-token: write
+    steps:
+      - name: Download legacy compatibility distributions
+        uses: actions/download-artifact@3e5f45b2cfb9172054b4087a40e8e0b5a5461e7c # v8.0.1
+        with:
+          name: python-legacy-compat-distributions
+          path: dist/
+
+      - name: Publish compatibility distribution once
+        uses: pypa/gh-action-pypi-publish@cef221092ed1bacb1cc03d23a2d87d1d172e277b # v1.14.0
+        with:
+          skip-existing: true

people_context-0.1.1/.github/workflows/scorecard.yml

@@ -0,0 +1,48 @@
+name: Scorecard analysis
+
+on:
+  push:
+    # Only the default branch is supported for published results.
+    branches:
+      - main
+  schedule:
+    # Weekly on Saturdays at 01:30 UTC.
+    - cron: "30 1 * * 6"
+
+# Keep the workflow read-only by default. The analysis job receives only the
+# two write permissions required to publish and upload its results.
+permissions: read-all
+
+jobs:
+  analysis:
+    name: Scorecard analysis
+    runs-on: ubuntu-latest
+    permissions:
+      # Upload SARIF results to GitHub's code-scanning dashboard.
+      security-events: write
+      # Obtain an OIDC token to publish authenticated results for the badge/API.
+      id-token: write
+    steps:
+      - name: Checkout code
+        uses: actions/checkout@9c091bb21b7c1c1d1991bb908d89e4e9dddfe3e0 # v7.0.0
+        with:
+          persist-credentials: false
+
+      - name: Run analysis
+        uses: ossf/scorecard-action@4eaacf0543bb3f2c246792bd56e8cdeffafb205a # v2.4.3
+        with:
+          results_file: results.sarif
+          results_format: sarif
+          publish_results: true
+
+      - name: Upload SARIF artifact
+        uses: actions/upload-artifact@043fb46d1a93c77aae656e7c1c64a875d1fc6a0a # v7.0.1
+        with:
+          name: scorecard-sarif
+          path: results.sarif
+          retention-days: 5
+
+      - name: Upload to code scanning
+        uses: github/codeql-action/upload-sarif@7188fc363630916deb702c7fdcf4e481b751f97a # v4.37.1
+        with:
+          sarif_file: results.sarif

people_context-0.1.1/.gitignore

@@ -0,0 +1,29 @@
+# Python
+__pycache__/
+*.py[cod]
+.venv/
+venv/
+dist/
+!openclaw-plugin/dist/
+!openclaw-plugin/dist/**
+build/
+*.egg-info/
+.pytest_cache/
+.ruff_cache/
+.coverage
+htmlcov/
+
+# Node
+node_modules/
+
+# Data (local SQLite store — never commit user data)
+*.db
+*.db-wal
+*.db-shm
+
+# OS / editor
+.DS_Store
+.idea/
+.vscode/
+
+tmp/

people_context-0.1.1/AGENTS.md

@@ -0,0 +1,39 @@
+# Repository Guidelines
+
+## Project Structure & Module Organization
+
+Application code lives under `src/people_context/` and follows a hexagonal architecture:
+
+- `domain/` contains Pydantic entities and dependency-free business rules.
+- `app/` contains one use case per module and depends only on `domain/` and narrow protocols in `ports/`.
+- `adapters/` contains SQLite persistence, MCP transports/tools, importers, and optional semantic integrations.
+- `cli.py`, `config.py`, and `adapters/mcp/server.py` are composition and process-boundary entry points.
+
+Tests mirror these layers under `tests/domain/`, `tests/app/`, and `tests/adapters/`. Design documentation, interface contracts, privacy rules, and ADRs live in `docs/`.
+
+## Build, Test, and Development Commands
+
+- `uv sync` installs the project and development dependencies.
+- `uv sync --extra semantic` explicitly installs optional Model2Vec and sqlite-vec support.
+- `uv run people-context-mcp` starts the default stdio MCP server.
+- `uv run people-context-mcp --http --host 127.0.0.1 --port 8765` starts loopback HTTP.
+- `uv run people-context db-path` shows the active SQLite database.
+- `uv run pytest -q` runs the complete test suite.
+- `uv run ruff check .` checks formatting-independent style and imports.
+- `uv build` creates source and wheel distributions.
+
+## Coding Style & Naming Conventions
+
+Use four-space indentation, complete type hints, and a 120-character line limit. Ruff enforces `E`, `F`, `I`, `UP`, `B`, and `SIM` rules. Name modules and functions with `snake_case`, classes with `PascalCase`, and constants with `UPPER_CASE`. Keep functions focused and prefer explicit dependency injection through `typing.Protocol` ports. Never import `adapters`, `mcp`, or `sqlite3` from `domain/` or `app/`.
+
+## Testing Guidelines
+
+Use pytest and name files `test_<subject>.py` and tests `test_<behavior>()`. Test application policy against in-memory fakes in `tests/app/fakes.py`; test persistence and transport behavior separately with SQLite and subprocess/E2E tests. Add a regression test for every bug and run focused tests before the full suite.
+
+## Commit & Pull Request Guidelines
+
+Use concise imperative Conventional Commit subjects, matching history: `feat: add ...`, `fix: report ...`, or `docs: mark ...`. Keep commits green and narrowly scoped. Pull requests should explain behavior and privacy impact, list verification commands, link relevant issues, and update interface or architecture documentation when contracts change.
+
+## Security & Configuration
+
+This repository stores sensitive personal data locally. Never persist raw import content or log private values. Keep HTTP loopback-only and unauthenticated; remote access is out of scope. Ordinary commands must not access the network—only explicit `people-context reindex --semantic` may download the pinned model.

people_context-0.1.1/LICENSE

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