team-memory 0.1.0__tar.gz

team_memory-0.1.0/.dockerignore

@@ -0,0 +1,14 @@
+.venv/
+__pycache__/
+*.pyc
+.git/
+.debug/
+.cursor/
+.ruff_cache/
+*.egg-info/
+dist/
+build/
+.pytest_cache/
+htmlcov/
+.env
+*.log

team_memory-0.1.0/.github/workflows/ci.yml

@@ -0,0 +1,78 @@
+name: CI
+
+on:
+  push:
+    branches: [main, develop]
+  pull_request:
+    branches: [main]
+
+env:
+  PYTHON_VERSION: "3.11"
+
+jobs:
+  lint:
+    name: Lint & Type Check
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+      - uses: actions/setup-python@v5
+        with:
+          python-version: ${{ env.PYTHON_VERSION }}
+      - name: Install dependencies
+        run: pip install -e ".[dev]"
+      - name: Ruff lint
+        run: ruff check src/ tests/
+      - name: Ruff format check
+        run: ruff format --check src/ tests/
+
+  test:
+    name: Tests
+    runs-on: ubuntu-latest
+    services:
+      postgres:
+        image: pgvector/pgvector:pg16
+        env:
+          POSTGRES_USER: developer
+          POSTGRES_PASSWORD: devpass
+          POSTGRES_DB: team_memory
+        ports:
+          - 5432:5432
+        options: >-
+          --health-cmd pg_isready
+          --health-interval 10s
+          --health-timeout 5s
+          --health-retries 5
+    env:
+      TEAM_MEMORY_DATABASE__URL: "postgresql+asyncpg://developer:devpass@localhost:5432/team_memory"
+    steps:
+      - uses: actions/checkout@v4
+      - uses: actions/setup-python@v5
+        with:
+          python-version: ${{ env.PYTHON_VERSION }}
+      - name: Install dependencies
+        run: pip install -e ".[dev]"
+      - name: Run migrations
+        run: alembic upgrade head
+      - name: Run tests
+        run: pytest -v --tb=short
+      - name: Coverage
+        run: pytest --cov=team_memory --cov-report=xml
+      - name: Upload coverage
+        uses: codecov/codecov-action@v4
+        with:
+          file: coverage.xml
+        continue-on-error: true
+
+  docker:
+    name: Docker Build
+    runs-on: ubuntu-latest
+    if: github.event_name == 'push'
+    needs: [lint, test]
+    steps:
+      - uses: actions/checkout@v4
+      - name: Set up Docker Buildx
+        uses: docker/setup-buildx-action@v3
+      - name: Build Docker image
+        run: |
+          docker build -t team_memory:${{ github.sha }} .
+          echo "Docker image built successfully"

team_memory-0.1.0/.gitignore

@@ -0,0 +1,42 @@
+# Python
+__pycache__/
+*.py[cod]
+*$py.class
+*.egg-info/
+dist/
+build/
+*.egg
+
+# Virtual environments
+.venv/
+venv/
+env/
+
+# IDE
+.idea/
+.vscode/
+
+# Config overrides (may contain secrets)
+config.local.yaml
+
+# Environment
+.env
+.env.*
+
+# Testing
+.coverage
+htmlcov/
+.pytest_cache/
+
+# Debug / operations docs (personal)
+.debug/
+
+# OS
+.DS_Store
+Thumbs.db
+
+
+.ruff_cache/
+migrations/
+.claude/
+.cursor/

team_memory-0.1.0/Dockerfile

@@ -0,0 +1,50 @@
+# Multi-stage Dockerfile for team_memory
+# Stage 1: Build
+FROM python:3.11-slim AS builder
+
+WORKDIR /app
+
+# Install build dependencies
+RUN pip install --no-cache-dir hatchling
+
+# Copy project files
+COPY pyproject.toml README.md ./
+COPY src/ ./src/
+COPY migrations/ ./migrations/
+COPY alembic.ini ./
+COPY config.yaml ./
+
+# Build the wheel
+RUN pip wheel --no-cache-dir --wheel-dir /wheels .
+
+# Stage 2: Runtime
+FROM python:3.11-slim AS runtime
+
+WORKDIR /app
+
+# Install runtime dependencies
+COPY --from=builder /wheels /wheels
+RUN pip install --no-cache-dir /wheels/*.whl && rm -rf /wheels
+
+# Copy migrations, config, and static files
+COPY migrations/ ./migrations/
+COPY alembic.ini ./
+COPY config.yaml ./
+COPY src/team_memory/web/static/ ./src/team_memory/web/static/
+
+# Copy entrypoint script
+COPY docker-entrypoint.sh /usr/local/bin/
+RUN chmod +x /usr/local/bin/docker-entrypoint.sh
+
+# Create a non-root user
+RUN useradd --create-home --shell /bin/bash appuser
+USER appuser
+
+# Expose port for web server
+EXPOSE 9111
+
+ENTRYPOINT ["docker-entrypoint.sh"]
+
+# Default: run the web server
+# Override with: docker run ... team-memory (for MCP server)
+CMD ["team-memory-web"]

team_memory-0.1.0/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2025 Team Memory Contributors
+
+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.

team_memory-0.1.0/Makefile

@@ -0,0 +1,61 @@
+# ============================================================
+# team_memory — 常用命令入口
+# 使用 make help 查看所有可用命令
+# ============================================================
+
+.DEFAULT_GOAL := help
+.PHONY: help setup dev web mcp test lint lint-fix backup health clean migrate install-knowledge
+
+help:           ## 显示所有可用命令
+	@echo ""
+	@echo "  team_memory 命令一览"
+	@echo "  ================================="
+	@grep -E '^[a-zA-Z_-]+:.*?## .*$$' $(MAKEFILE_LIST) | \
+	  awk 'BEGIN {FS = ":.*?## "}; {printf "  make %-15s %s\n", $$1, $$2}'
+	@echo ""
+
+setup:          ## 首次安装：启动 Docker + 安装依赖 + 初始化数据库
+	docker compose up -d
+	pip install -e ".[dev]"
+	alembic upgrade head
+	@echo ""
+	@echo "  ✔ Setup complete!"
+	@echo "  Run 'make web' to start the Web UI."
+	@echo "  Run 'make mcp' to start the MCP server."
+	@echo ""
+
+dev:            ## 启动全部服务（Docker 基础设施 + Web 管理界面）
+	docker compose up -d
+	python -m team_memory.web.app
+
+web:            ## 仅启动 Web 管理界面（默认端口 9111）
+	python -m team_memory.web.app
+
+mcp:            ## 仅启动 MCP Server（供 Cursor / Claude Desktop 使用）
+	python -m team_memory.server
+
+test:           ## 运行全部测试
+	pytest tests/ -v
+
+lint:           ## Ruff 代码检查
+	ruff check src/
+
+lint-fix:       ## Ruff 代码检查并自动修复
+	ruff check src/ --fix
+
+migrate:        ## 运行数据库迁移
+	alembic upgrade head
+
+backup:         ## 备份数据库
+	./scripts/backup.sh
+
+health:         ## 一键健康检查（检测所有组件状态）
+	./scripts/healthcheck.sh
+
+clean:          ## 清理 Python 缓存文件
+	find . -type d -name __pycache__ -exec rm -rf {} + 2>/dev/null || true
+	find . -type f -name "*.pyc" -delete 2>/dev/null || true
+	find . -type d -name ".pytest_cache" -exec rm -rf {} + 2>/dev/null || true
+
+install-knowledge: ## 一键安装固化知识包（rules + skill）
+	./scripts/install_codified_knowledge.sh