工作记忆与时间跟踪服务器

# Run directly with uvx (automatically installs and runs)
uvx --from git+https://github.com/jarosser06/mosaic mosaic

# Or from a local clone
git clone https://github.com/jarosser06/mosaic
cd mosaic
uvx --from . mosaic

git clone https://github.com/jarosser06/mosaic
cd mosaic
uv sync

cd docker
docker-compose up -d postgres
cd ..

cp .env.example .env

# Database Configuration
DATABASE_URL=postgresql+asyncpg://username:password@host:port/database

# Example for Docker setup
DATABASE_URL=postgresql+asyncpg://mosaic:changeme_supersecret_password@localhost:5433/mosaic

# Example for local PostgreSQL
DATABASE_URL=postgresql+asyncpg://myuser:mypass@localhost:5432/mosaic

# Example for cloud PostgreSQL (AWS RDS, etc.)
DATABASE_URL=postgresql+asyncpg://admin:secret@mydb.region.rds.amazonaws.com:5432/mosaic

uv run alembic upgrade head

# Using the installed script
uv run mosaic

# Or directly
uv run python -m mosaic.server

{
  "mcpServers": {
    "mosaic": {
      "command": "uvx",
      "args": [
        "--from",
        "git+https://github.com/jarosser06/mosaic",
        "mosaic"
      ],
      "env": {
        "DATABASE_URL": "postgresql+asyncpg://mosaic:changeme_supersecret_password@localhost:5433/mosaic"
      }
    }
  }
}

{
  "mcpServers": {
    "mosaic": {
      "command": "uv",
      "args": ["run", "mosaic"],
      "cwd": "/absolute/path/to/mosaic"
    }
  }
}

uv run python scripts/test_notifications.py

# Ad-hoc signature (sufficient for local use)
codesign -s - $(which python3)

# Or sign with your Apple Developer certificate
codesign -s "Your Name" $(which python3)

# After installing from python.org
which python3  # Should show /Library/Frameworks/Python.framework/...

codesign -s - path/to/mosaic.app

# Test script checks signing and sends test notification
uv run python scripts/test_notifications.py

"Log 2.5 hours of work on the API project"
"I worked on the frontend from 9am to 11:30am yesterday"

"Log a meeting with John Smith about the Q1 roadmap from 2pm to 3pm"
"Add a 30-minute standup meeting with the team"

"Show me all work sessions from last week"
"What meetings did I have with Acme Corp this month?"
"Find all notes tagged 'urgent'"
"Show public work sessions for timecard generation"

"Create a project called 'Website Redesign' for Acme Corp"
"Add a note to the API project: 'Need to implement rate limiting'"
"Set the website project status to active"

mosaic/
├── src/mosaic/
│   ├── server.py              # MCP server entry point
│   ├── config.py              # Pydantic settings
│   ├── models/                # SQLAlchemy models (11 entities)
│   ├── repositories/          # Data access layer
│   ├── services/              # Business logic
│   ├── tools/                 # MCP tool implementations (18 tools)
│   └── schemas/               # Pydantic validation schemas
├── tests/
│   ├── unit/                  # Model, service, repository tests
│   └── integration/           # End-to-end MCP tool tests
├── alembic/                   # Database migrations
├── docker/                    # Optional Docker setup
└── pyproject.toml             # Dependencies and config

# Run all tests with coverage (requires 90%+)
uv run pytest

# Run specific test file
uv run pytest tests/integration/test_query_tool.py

# Format code
uv run black src/ tests/

# Sort imports
uv run isort src/ tests/

# Linting
uv run flake8 src/ tests/

# Install pre-commit hooks (runs all checks on commit)
uv run pre-commit install

# Run all checks manually
uv run pre-commit run --all-files

# Create a new migration after model changes
uv run alembic revision --autogenerate -m "Description of changes"

# Apply migrations
uv run alembic upgrade head

# Rollback one migration
uv run alembic downgrade -1

# View migration history
uv run alembic history

# Check current version
uv run alembic current

uv run black alembic/versions/xxx_your_migration.py

uv run alembic upgrade head

cd docker
docker-compose down -v  # Removes volumes
docker-compose up -d postgres
cd ..
uv run alembic upgrade head

# Drop and recreate your database using your PostgreSQL client
# Then run migrations
uv run alembic upgrade head

# Database connection (REQUIRED)
DATABASE_URL=postgresql+asyncpg://user:pass@host:port/db

# APScheduler job store (optional, defaults to same as DATABASE_URL)
APSCHEDULER_JOB_STORE_URL=postgresql+asyncpg://user:pass@host:port/db

# Application settings (optional)
LOG_LEVEL=INFO
ENVIRONMENT=development

# Notification settings (optional, requires notification bridge)
NOTIFICATION_ENABLED=true
NOTIFICATION_SOUND=default
NOTIFICATION_BRIDGE_URL=http://host.docker.internal:8765

cd docker
docker-compose up -d postgres

# Build image
docker build -f docker/Dockerfile -t mosaic:latest .

# Run with docker-compose
cd docker
docker-compose up -d