matter2 0.3.0__tar.gz

matter2-0.3.0/.gitattributes

@@ -0,0 +1,14 @@
+    # Set the default behavior to LF EOL
+    * text=auto eol=lf
+
+    # Explicitly declare text files you want to always be normalized and converted
+    # to native line endings on checkout.
+    *.c text
+    *.h text
+
+    # Declare files that will always have LF line endings on checkout.
+    *.sln text eol=lf
+
+    # Denote all files that are truly binary and should not be modified.
+    *.png binary
+    *.jpg binary

matter2-0.3.0/.github/workflows/claude-code-review.yml

@@ -0,0 +1,44 @@
+name: Claude Code Review
+
+on:
+  pull_request:
+    types: [opened, synchronize, ready_for_review, reopened]
+    # Optional: Only run on specific file changes
+    # paths:
+    #   - "src/**/*.ts"
+    #   - "src/**/*.tsx"
+    #   - "src/**/*.js"
+    #   - "src/**/*.jsx"
+
+jobs:
+  claude-review:
+    # Optional: Filter by PR author
+    # if: |
+    #   github.event.pull_request.user.login == 'external-contributor' ||
+    #   github.event.pull_request.user.login == 'new-developer' ||
+    #   github.event.pull_request.author_association == 'FIRST_TIME_CONTRIBUTOR'
+
+    runs-on: ubuntu-latest
+    permissions:
+      contents: read
+      pull-requests: read
+      issues: read
+      id-token: write
+
+    steps:
+      - name: Checkout repository
+        uses: actions/checkout@v4
+        with:
+          fetch-depth: 1
+
+      - name: Run Claude Code Review
+        id: claude-review
+        uses: anthropics/claude-code-action@v1
+        with:
+          claude_code_oauth_token: ${{ secrets.CLAUDE_CODE_OAUTH_TOKEN }}
+          plugin_marketplaces: 'https://github.com/anthropics/claude-code.git'
+          plugins: 'code-review@claude-code-plugins'
+          prompt: '/code-review:code-review ${{ github.repository }}/pull/${{ github.event.pull_request.number }}'
+          # See https://github.com/anthropics/claude-code-action/blob/main/docs/usage.md
+          # or https://code.claude.com/docs/en/cli-reference for available options
+

matter2-0.3.0/.github/workflows/claude.yml

@@ -0,0 +1,50 @@
+name: Claude Code
+
+on:
+  issue_comment:
+    types: [created]
+  pull_request_review_comment:
+    types: [created]
+  issues:
+    types: [opened, assigned]
+  pull_request_review:
+    types: [submitted]
+
+jobs:
+  claude:
+    if: |
+      (github.event_name == 'issue_comment' && contains(github.event.comment.body, '@claude')) ||
+      (github.event_name == 'pull_request_review_comment' && contains(github.event.comment.body, '@claude')) ||
+      (github.event_name == 'pull_request_review' && contains(github.event.review.body, '@claude')) ||
+      (github.event_name == 'issues' && (contains(github.event.issue.body, '@claude') || contains(github.event.issue.title, '@claude')))
+    runs-on: ubuntu-latest
+    permissions:
+      contents: read
+      pull-requests: read
+      issues: read
+      id-token: write
+      actions: read # Required for Claude to read CI results on PRs
+    steps:
+      - name: Checkout repository
+        uses: actions/checkout@v4
+        with:
+          fetch-depth: 1
+
+      - name: Run Claude Code
+        id: claude
+        uses: anthropics/claude-code-action@v1
+        with:
+          claude_code_oauth_token: ${{ secrets.CLAUDE_CODE_OAUTH_TOKEN }}
+
+          # This is an optional setting that allows Claude to read CI results on PRs
+          additional_permissions: |
+            actions: read
+
+          # Optional: Give a custom prompt to Claude. If this is not specified, Claude will perform the instructions specified in the comment that tagged it.
+          # prompt: 'Update the pull request description to include a summary of changes.'
+
+          # Optional: Add claude_args to customize behavior and configuration
+          # See https://github.com/anthropics/claude-code-action/blob/main/docs/usage.md
+          # or https://code.claude.com/docs/en/cli-reference for available options
+          # claude_args: '--allowed-tools Bash(gh pr:*)'
+

matter2-0.3.0/.github/workflows/publish.yml

@@ -0,0 +1,43 @@
+name: Publish to PyPI
+
+on:
+  release:
+    types: [published]
+
+permissions:
+  id-token: write
+
+jobs:
+  build:
+    name: Build distribution
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+      - uses: actions/setup-python@v5
+        with:
+          python-version: "3.12"
+      - name: Install build tools
+        run: pip install build
+      - name: Build package
+        run: python -m build
+      - name: Upload dist artifacts
+        uses: actions/upload-artifact@v4
+        with:
+          name: dist
+          path: dist/
+
+  publish:
+    name: Publish to PyPI
+    needs: build
+    runs-on: ubuntu-latest
+    environment: pypi
+    permissions:
+      id-token: write
+    steps:
+      - name: Download dist artifacts
+        uses: actions/download-artifact@v4
+        with:
+          name: dist
+          path: dist/
+      - name: Publish to PyPI
+        uses: pypa/gh-action-pypi-publish@release/v1

matter2-0.3.0/.github/workflows/tests.yml

@@ -0,0 +1,28 @@
+name: Tests
+
+on:
+  push:
+    branches: [main]
+  pull_request:
+    branches: [main]
+
+jobs:
+  test:
+    runs-on: ubuntu-latest
+    strategy:
+      matrix:
+        python-version: ["3.10", "3.11", "3.12", "3.13"]
+
+    steps:
+      - uses: actions/checkout@v4
+
+      - name: Set up Python ${{ matrix.python-version }}
+        uses: actions/setup-python@v5
+        with:
+          python-version: ${{ matrix.python-version }}
+
+      - name: Install dependencies
+        run: pip install -e ".[dev,diff]"
+
+      - name: Run tests
+        run: pytest tests -v

matter2-0.3.0/.gitignore

@@ -0,0 +1,163 @@
+# Byte-compiled / optimized / DLL files
+__pycache__/
+*.py[cod]
+*$py.class
+
+# C extensions
+*.so
+
+# Distribution / packaging
+.Python
+build/
+develop-eggs/
+dist/
+downloads/
+eggs/
+.eggs/
+lib/
+lib64/
+parts/
+sdist/
+var/
+wheels/
+share/python-wheels/
+*.egg-info/
+.installed.cfg
+*.egg
+MANIFEST
+
+# PyInstaller
+#  Usually these files are written by a python script from a template
+#  before PyInstaller builds the exe, so as to inject date/other infos into it.
+*.manifest
+*.spec
+
+# Installer logs
+pip-log.txt
+pip-delete-this-directory.txt
+
+# Unit test / coverage reports
+htmlcov/
+.tox/
+.nox/
+.coverage
+.coverage.*
+.cache
+nosetests.xml
+coverage.xml
+*.cover
+*.py,cover
+.hypothesis/
+.pytest_cache/
+cover/
+
+# Translations
+*.mo
+*.pot
+
+# Django stuff:
+*.log
+local_settings.py
+db.sqlite3
+db.sqlite3-journal
+
+# Flask stuff:
+instance/
+.webassets-cache
+
+# Scrapy stuff:
+.scrapy
+
+# Sphinx documentation
+docs/_build/
+
+# PyBuilder
+.pybuilder/
+target/
+
+# Jupyter Notebook
+.ipynb_checkpoints
+
+# IPython
+profile_default/
+ipython_config.py
+
+# pyenv
+#   For a library or package, you might want to ignore these files since the code is
+#   intended to run in multiple environments; otherwise, check them in:
+# .python-version
+
+# pipenv
+#   According to pypa/pipenv#598, it is recommended to include Pipfile.lock in version control.
+#   However, in case of collaboration, if having platform-specific dependencies or dependencies
+#   having no cross-platform support, pipenv may install dependencies that don't work, or not
+#   install all needed dependencies.
+#Pipfile.lock
+
+# poetry
+#   Similar to Pipfile.lock, it is generally recommended to include poetry.lock in version control.
+#   This is especially recommended for binary packages to ensure reproducibility, and is more
+#   commonly ignored for libraries.
+#   https://python-poetry.org/docs/basic-usage/#commit-your-poetrylock-file-to-version-control
+#poetry.lock
+
+# pdm
+#   Similar to Pipfile.lock, it is generally recommended to include pdm.lock in version control.
+#pdm.lock
+#   pdm stores project-wide configurations in .pdm.toml, but it is recommended to not include it
+#   in version control.
+#   https://pdm.fming.dev/#use-with-ide
+.pdm.toml
+
+# PEP 582; used by e.g. github.com/David-OConnor/pyflow and github.com/pdm-project/pdm
+__pypackages__/
+
+# Celery stuff
+celerybeat-schedule
+celerybeat.pid
+
+# SageMath parsed files
+*.sage.py
+
+# Environments
+.env
+.venv
+env/
+venv/
+ENV/
+env.bak/
+venv.bak/
+
+# Spyder project settings
+.spyderproject
+.spyproject
+
+# Rope project settings
+.ropeproject
+
+# mkdocs documentation
+/site
+
+# mypy
+.mypy_cache/
+.dmypy.json
+dmypy.json
+
+# Pyre type checker
+.pyre/
+
+# pytype static type analyzer
+.pytype/
+
+# Cython debug symbols
+cython_debug/
+
+# PyCharm
+#  JetBrains specific template is maintained in a separate JetBrains.gitignore that can
+#  be found at https://github.com/github/gitignore/blob/main/Global/JetBrains.gitignore
+#  and can be added to the global gitignore or merged into this file.  For a more nuclear
+#  option (not recommended) you can uncomment the following to ignore the entire idea folder.
+#.idea/
+
+# Just in case we created a matter repo in the root during testing, ignore it.
+.matter/

matter2-0.3.0/.idea/.gitignore

@@ -0,0 +1,8 @@
+# Default ignored files
+/shelf/
+/workspace.xml
+# Editor-based HTTP Client requests
+/httpRequests/
+# Datasource local storage ignored files
+/dataSources/
+/dataSources.local.xml

matter2-0.3.0/.idea/Matter2.iml

@@ -0,0 +1,14 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<module type="PYTHON_MODULE" version="4">
+  <component name="NewModuleRootManager">
+    <content url="file://$MODULE_DIR$">
+      <excludeFolder url="file://$MODULE_DIR$/.venv" />
+    </content>
+    <orderEntry type="jdk" jdkName="Python 3.10 (Matter2)" jdkType="Python SDK" />
+    <orderEntry type="sourceFolder" forTests="false" />
+  </component>
+  <component name="PyDocumentationSettings">
+    <option name="format" value="PLAIN" />
+    <option name="myDocStringFormat" value="Plain" />
+  </component>
+</module>

matter2-0.3.0/.idea/inspectionProfiles/profiles_settings.xml

@@ -0,0 +1,6 @@
+<component name="InspectionProjectProfileManager">
+  <settings>
+    <option name="USE_PROJECT_PROFILE" value="false" />
+    <version value="1.0" />
+  </settings>
+</component>

matter2-0.3.0/.idea/misc.xml

@@ -0,0 +1,7 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<project version="4">
+  <component name="Black">
+    <option name="sdkName" value="Python 3.10" />
+  </component>
+  <component name="ProjectRootManager" version="2" project-jdk-name="Python 3.10 (Matter2)" project-jdk-type="Python SDK" />
+</project>

matter2-0.3.0/.idea/modules.xml

@@ -0,0 +1,8 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<project version="4">
+  <component name="ProjectModuleManager">
+    <modules>
+      <module fileurl="file://$PROJECT_DIR$/.idea/Matter2.iml" filepath="$PROJECT_DIR$/.idea/Matter2.iml" />
+    </modules>
+  </component>
+</project>

matter2-0.3.0/.idea/vcs.xml

@@ -0,0 +1,6 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<project version="4">
+  <component name="VcsDirectoryMappings">
+    <mapping directory="" vcs="Git" />
+  </component>
+</project>

matter2-0.3.0/CLAUDE.md

@@ -0,0 +1,61 @@
+# CLAUDE.md
+
+This file provides guidance to Claude Code (claude.ai/code) when working with code in this repository.
+
+## Project Overview
+
+Matter2 is a purpose-built VCS for office documents (DOCX, PPTX, PDF, etc.). CLI-first tool (like Git) with a clean library interface. ZIP-aware storage unpacks office formats for efficient delta storage. Hash-based document identity tracking across renames. No ML dependencies in core.
+
+## Build & Development
+
+```bash
+pip install -e ".[dev,diff]"
+```
+
+## Testing
+
+```bash
+pytest tests                                  # all tests
+pytest tests/storage/test_objects.py          # single file
+pytest tests/test_repository.py::TestClass::test_method  # single test
+pytest tests -v                               # verbose
+```
+
+Tests use pytest with `tmp_path` fixtures. Test DOCX/ZIP files are created programmatically via helpers in `tests/conftest.py` (`make_zip`, `make_docx`).
+
+## Linting
+
+```bash
+ruff check .
+black --check .
+```
+
+Line length: 120. Target: Python 3.10+.
+
+## Architecture
+
+### Layer Diagram
+
+```
+CLI (Click/Rich) -> Repository -> Engine -> Storage + Metadata
+```
+
+- **`matter/storage/`** — Content-addressed object store. ZIP-aware: unpacks office formats, stores internal files individually with dedup. Objects sharded by SHA-256 prefix.
+- **`matter/metadata/`** — SQLite via Peewee ORM. Tables: Checkpoint (commits), Branch, TreeEntry, Document (stable UUID), RepoState.
+- **`matter/engine/`** — Business logic: status detection, staging, commit creation, branch management, merge with conflict detection, document identity/rename tracking.
+- **`matter/diff/`** — Text extraction + unified diff. Optional LLM summaries.
+- **`matter/cli/`** — Click commands + Rich display. Never touches storage/metadata directly.
+- **`matter/repository.py`** — `Repository` class, the sole public API. No interactive prompts.
+
+### Git & VCS Rules
+
+- Never mention Claude, Anthropic, or any AI assistant in commit messages, PR titles, PR descriptions, or any VCS artifact. No Co-Authored-By lines, no "Generated by" footers, nothing.
+
+### Key Design Rules
+
+- Storage and metadata layers are independent of each other
+- The engine layer connects them
+- The CLI only talks to Repository
+- The library never prompts the user — conflicts/choices returned as data
+- ZIP internals treated as opaque bytes, never parsed/validated
+- All paths in metadata are relative to repo root

matter2-0.3.0/LICENSE.txt

@@ -0,0 +1,9 @@
+MIT License
+
+Copyright (c) 2023-present JSv4 <scrudato@umich.edu>
+
+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.

matter2-0.3.0/PKG-INFO

@@ -0,0 +1,106 @@
+Metadata-Version: 2.4
+Name: matter2
+Version: 0.3.0
+Summary: A version control system for office documents
+Project-URL: Source, https://github.com/JSv4/Matter2
+Project-URL: Issues, https://github.com/JSv4/Matter2/issues
+Author-email: JSv4 <scrudato@umich.edu>
+License-Expression: MIT
+License-File: LICENSE.txt
+Keywords: documents,vcs,version-control
+Classifier: Development Status :: 3 - Alpha
+Classifier: Programming Language :: Python
+Classifier: Programming Language :: Python :: 3.10
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Programming Language :: Python :: 3.13
+Requires-Python: >=3.10
+Requires-Dist: click>=8.0
+Requires-Dist: peewee>=3.16
+Requires-Dist: rich>=13
+Provides-Extra: dev
+Requires-Dist: pytest-tmp-files>=0.0.2; extra == 'dev'
+Requires-Dist: pytest>=7.0; extra == 'dev'
+Provides-Extra: diff
+Requires-Dist: pypdf>=3.12; extra == 'diff'
+Requires-Dist: python-docx>=0.8.11; extra == 'diff'
+Provides-Extra: llm
+Requires-Dist: anthropic>=0.20; extra == 'llm'
+Description-Content-Type: text/markdown
+
+# Matter2
+
+A version control system for office documents.
+
+[![PyPI - Version](https://img.shields.io/pypi/v/matter2.svg)](https://pypi.org/project/matter2)
+
+## What is Matter?
+
+Matter is a VCS designed for office documents (DOCX, PPTX, PDF, etc.) rather than source code. It provides:
+
+- **ZIP-aware storage** — Office formats are unpacked and stored efficiently. A one-word edit to a DOCX doesn't duplicate the entire file.
+- **Document identity tracking** — Rename a file and Matter knows it's the same document.
+- **Branch and merge** — Branch document collections for review cycles. Conflicts are surfaced as side-by-side files for manual resolution.
+- **Portable format** — Export a repository as a self-contained archive.
+
+## Installation
+
+```bash
+pip install matter2
+```
+
+With optional diff support (DOCX/PDF text extraction):
+
+```bash
+pip install matter2[diff]
+```
+
+## Quick Start
+
+```bash
+# Initialize a repository
+matter init
+
+# Add and commit documents
+matter add contract.docx proposal.pdf
+matter commit -m "Initial documents" -a user@example.com
+
+# Check status
+matter status
+
+# View history
+matter log
+
+# Branch for review
+matter branch client-review
+matter switch client-review
+
+# Merge back
+matter switch main
+matter merge client-review
+
+# Track a document across renames
+matter track contract.docx
+
+# Export for sharing
+matter export backup.tar.gz
+```
+
+## Library Usage
+
+```python
+from matter import Repository
+
+repo = Repository.init("/path/to/repo")
+repo.add(["contract.docx"])
+cp = repo.commit(message="Add contract", author="user@example.com")
+content = repo.restore(cp.id, "contract.docx")
+```
+
+## Architecture
+
+See [design spec](docs/superpowers/specs/2026-04-08-matter2-redesign-design.md) for the full architecture.
+
+## License
+
+MIT

matter2-0.3.0/README.md

@@ -0,0 +1,76 @@
+# Matter2
+
+A version control system for office documents.
+
+[![PyPI - Version](https://img.shields.io/pypi/v/matter2.svg)](https://pypi.org/project/matter2)
+
+## What is Matter?
+
+Matter is a VCS designed for office documents (DOCX, PPTX, PDF, etc.) rather than source code. It provides:
+
+- **ZIP-aware storage** — Office formats are unpacked and stored efficiently. A one-word edit to a DOCX doesn't duplicate the entire file.
+- **Document identity tracking** — Rename a file and Matter knows it's the same document.
+- **Branch and merge** — Branch document collections for review cycles. Conflicts are surfaced as side-by-side files for manual resolution.
+- **Portable format** — Export a repository as a self-contained archive.
+
+## Installation
+
+```bash
+pip install matter2
+```
+
+With optional diff support (DOCX/PDF text extraction):
+
+```bash
+pip install matter2[diff]
+```
+
+## Quick Start
+
+```bash
+# Initialize a repository
+matter init
+
+# Add and commit documents
+matter add contract.docx proposal.pdf
+matter commit -m "Initial documents" -a user@example.com
+
+# Check status
+matter status
+
+# View history
+matter log
+
+# Branch for review
+matter branch client-review
+matter switch client-review
+
+# Merge back
+matter switch main
+matter merge client-review
+
+# Track a document across renames
+matter track contract.docx
+
+# Export for sharing
+matter export backup.tar.gz
+```
+
+## Library Usage
+
+```python
+from matter import Repository
+
+repo = Repository.init("/path/to/repo")
+repo.add(["contract.docx"])
+cp = repo.commit(message="Add contract", author="user@example.com")
+content = repo.restore(cp.id, "contract.docx")
+```
+
+## Architecture
+
+See [design spec](docs/superpowers/specs/2026-04-08-matter2-redesign-design.md) for the full architecture.
+
+## License
+
+MIT