Initial project setup

Created by development-hub/new-project script

.gitignore

@@ -0,0 +1,53 @@
+# Python
+__pycache__/
+*.py[cod]
+*$py.class
+*.so
+.Python
+build/
+develop-eggs/
+dist/
+downloads/
+eggs/
+.eggs/
+lib/
+lib64/
+parts/
+sdist/
+var/
+wheels/
+*.egg-info/
+.installed.cfg
+*.egg
+
+# Virtual environments
+.venv/
+venv/
+ENV/
+
+# IDE
+.idea/
+.vscode/
+*.swp
+*.swo
+
+# OS
+.DS_Store
+Thumbs.db
+
+# Testing
+.pytest_cache/
+.coverage
+htmlcov/
+.tox/
+.nox/
+
+# mypy
+.mypy_cache/
+
+# Local config
+.env
+*.local.yaml
+
+# Documentation symlink (points to project-docs)
+docs

CLAUDE.md

@@ -0,0 +1,48 @@
+# CLAUDE.md
+
+This file provides guidance to Claude Code (claude.ai/code) when working with code in this repository.
+
+## Project Overview
+
+**Fading Memories** - Hierarchical conversation compression with natural memory decay
+
+## Development Commands
+
+```bash
+# Install for development
+pip install -e ".[dev]"
+
+# Run tests
+pytest
+
+# Run a single test
+pytest tests/test_file.py::test_name
+```
+
+## Architecture
+
+*TODO: Describe the project architecture*
+
+### Key Modules
+
+*TODO: List key modules and their purposes*
+
+### Key Paths
+
+- **Source code**: `src/fading-memories/`
+- **Tests**: `tests/`
+- **Documentation**: `docs/` (symlink to project-docs)
+
+## Documentation
+
+Documentation lives in `docs/` (symlink to centralized docs system).
+
+**Before updating docs, read `docs/updating-documentation.md`** for full details on visibility rules and procedures.
+
+Quick reference:
+- Edit files in `docs/` folder
+- Use `public: true` frontmatter for public-facing docs
+- Use `<!-- PRIVATE_START -->` / `<!-- PRIVATE_END -->` to hide sections
+- Deploy: `~/PycharmProjects/project-docs/scripts/build-public-docs.sh fading-memories --deploy`
+
+Do NOT create documentation files directly in this repository.

README.md

@@ -0,0 +1,39 @@
+# Fading Memories
+
+Hierarchical conversation compression with natural memory decay
+
+## Installation
+
+```bash
+pip install -e .
+```
+
+## Usage
+
+*TODO: Add usage instructions*
+
+## Documentation
+
+Full documentation is available at: https://pages.brrd.tech/rob/fading-memories/
+
+## Development
+
+```bash
+# Clone the repository
+git clone https://gitea.brrd.tech/rob/fading-memories.git
+cd fading-memories
+
+# Create virtual environment
+python -m venv .venv
+source .venv/bin/activate
+
+# Install for development
+pip install -e ".[dev]"
+
+# Run tests
+pytest
+```
+
+## License
+
+*TODO: Add license*

pyproject.toml

@@ -0,0 +1,23 @@
+[build-system]
+requires = ["setuptools>=61.0", "wheel"]
+build-backend = "setuptools.build_meta"
+
+[project]
+name = "fading-memories"
+version = "0.1.0"
+description = "Hierarchical conversation compression with natural memory decay"
+readme = "README.md"
+requires-python = ">=3.10"
+dependencies = []
+
+[project.optional-dependencies]
+dev = [
+    "pytest>=7.0",
+    "pytest-cov>=4.0",
+]
+
+[tool.setuptools.packages.find]
+where = ["src"]
+
+[tool.pytest.ini_options]
+testpaths = ["tests"]