mapsmith 0.1.0__tar.gz

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

@@ -0,0 +1,31 @@
+name: CI
+
+on:
+  push:
+    branches: [main]
+  pull_request:
+
+jobs:
+  test:
+    runs-on: ubuntu-latest
+    strategy:
+      matrix:
+        python-version: ["3.10", "3.12"]
+    steps:
+      - uses: actions/checkout@v4
+      - uses: actions/setup-python@v5
+        with:
+          python-version: ${{ matrix.python-version }}
+      - name: Install
+        run: pip install -e .[test]
+      - name: Lint
+        run: ruff check .
+      - name: Test
+        run: pytest -q
+
+  docker:
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+      - name: Build image
+        run: docker build -t mapsmith:ci .

mapsmith-0.1.0/.github/workflows/docker-publish.yml

@@ -0,0 +1,34 @@
+name: Publish image
+
+on:
+  push:
+    branches: [main]
+    tags: ["v*"]
+
+jobs:
+  publish:
+    runs-on: ubuntu-latest
+    permissions:
+      contents: read
+      packages: write
+    steps:
+      - uses: actions/checkout@v7
+      - uses: docker/login-action@v4
+        with:
+          registry: ghcr.io
+          username: ${{ github.actor }}
+          password: ${{ secrets.GITHUB_TOKEN }}
+      - uses: docker/metadata-action@v6
+        id: meta
+        with:
+          images: ghcr.io/${{ github.repository }}
+          tags: |
+            type=ref,event=branch
+            type=semver,pattern={{version}}
+            type=raw,value=latest,enable={{is_default_branch}}
+      - uses: docker/build-push-action@v7
+        with:
+          context: .
+          push: true
+          tags: ${{ steps.meta.outputs.tags }}
+          labels: ${{ steps.meta.outputs.labels }}

mapsmith-0.1.0/.gitignore

@@ -0,0 +1,29 @@
+# Python
+__pycache__/
+*.py[cod]
+*.egg-info/
+dist/
+build/
+.venv/
+venv/
+.pytest_cache/
+.ruff_cache/
+
+# Data & outputs (never commit datasets)
+*.gpkg
+*.gpkg-journal
+*.shp
+*.shx
+*.dbf
+*.prj
+*.tif
+*.tiff
+*.parquet
+*.provenance.json
+data/
+
+# OS / editors
+.DS_Store
+Thumbs.db
+.vscode/
+.idea/

mapsmith-0.1.0/CONTRIBUTING.md

@@ -0,0 +1,37 @@
+# Contributing to MapSmith
+
+Thanks for your interest! A few ground rules keep this project sustainable for a small team.
+
+## Ways to contribute
+
+- **New operations**: open a PR adding an engine function + MCP tool + catalog entry + test. Small, focused PRs merge fastest. (There is deliberately no plugin API yet — new tools land in core through one review queue.)
+- **Bug reports**: use the issue template. We aim for a **first response within 48 hours**.
+- **Docs & analysis notebooks**: gallery examples (prompt → tool chain → map) are as valuable as code.
+
+## Environment support policy
+
+**Docker (or `uvx` where wheels work) is the only supported install path.** Issues that reduce to a broken local GDAL/compiler setup will be closed with a pointer to the container. This is not unfriendliness — it is how a small team keeps the 48h response promise.
+
+## Development setup
+
+```bash
+pip install -e .[test]
+pytest -q
+ruff check .
+```
+
+## Design rules (enforced in review)
+
+1. **Deterministic outputs only.** No geometry or numeric result may originate from an LLM.
+2. **Every writer emits provenance.** If your operation writes a dataset, it writes a manifest (`ProvenanceRecord`) — inputs with checksums, parameters, CRS decisions, engine versions.
+3. **No silent CRS decisions.** Reprojections and unit assumptions must be recorded in `crs_decisions`.
+4. **GPL isolation.** GPL engines (QGIS, GRASS) may only be invoked as external processes (CLI/files/JSON). Never `import qgis` or link GPL libraries in-process.
+5. **Few semantic tools.** New MCP tools need a strong case; prefer extending the catalog + existing tools.
+
+## Contributor License Agreement
+
+To keep dual-licensing possible (AGPL + commercial), we ask contributors to sign a lightweight CLA on their first PR (automated via bot). Your code always remains available under AGPL-3.0.
+
+## Code style
+
+Python ≥3.10, `ruff` clean, type hints on public functions, tests for every operation.

mapsmith-0.1.0/Dockerfile

@@ -0,0 +1,13 @@
+FROM python:3.12-slim
+
+# Geospatial wheels (pyogrio/shapely/pyproj) bundle their native libs; no system GDAL needed.
+WORKDIR /app
+COPY pyproject.toml README.md LICENSE ./
+COPY src ./src
+RUN pip install --no-cache-dir .
+
+# Workspace for datasets: mount your data here
+VOLUME ["/data"]
+WORKDIR /data
+
+ENTRYPOINT ["mapsmith"]