mindyard 0.1.0__tar.gz

mindyard-0.1.0/.dockerignore

@@ -0,0 +1,8 @@
+.git
+.venv
+**/__pycache__
+.ruff_cache
+.mypy_cache
+.pytest_cache
+tests
+docs

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

@@ -0,0 +1,23 @@
+name: CI
+
+on:
+  push:
+    branches: [main]
+  pull_request:
+
+permissions:
+  contents: read
+
+jobs:
+  checks:
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+      - uses: astral-sh/setup-uv@v10.3.0
+        with:
+          python-version: "3.12"
+      - run: uv sync --frozen
+      - run: uv run ruff check
+      - run: uv run ruff format --check
+      - run: uv run mypy
+      - run: uv run pytest -q

mindyard-0.1.0/.github/workflows/release.yml

@@ -0,0 +1,50 @@
+name: Release
+
+on:
+  push:
+    tags: ["v*"]
+
+permissions:
+  contents: read
+
+jobs:
+  build:
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+      - uses: astral-sh/setup-uv@v10.3.0
+        with:
+          python-version: "3.12"
+      - run: uv sync --frozen
+      - run: uv run ruff check
+      - run: uv run ruff format --check
+      - run: uv run mypy
+      - run: uv run pytest -q
+      - name: Tag matches the package version
+        run: |
+          version="$(uv run python -c 'import mindyard; print(mindyard.__version__)')"
+          test "v$version" = "$GITHUB_REF_NAME" || {
+            echo "tag $GITHUB_REF_NAME does not match version $version" >&2
+            exit 1
+          }
+      - run: uv build
+      - uses: actions/upload-artifact@v4
+        with:
+          name: dist
+          path: dist/
+
+  publish:
+    needs: build
+    runs-on: ubuntu-latest
+    # Trusted publishing: PyPI trusts this workflow and environment, no token is stored.
+    environment:
+      name: pypi
+      url: https://pypi.org/project/mindyard/
+    permissions:
+      id-token: write
+    steps:
+      - uses: actions/download-artifact@v4
+        with:
+          name: dist
+          path: dist/
+      - uses: pypa/gh-action-pypi-publish@release/v1

mindyard-0.1.0/.gitignore

@@ -0,0 +1,11 @@
+.env
+.venv/
+__pycache__/
+node_modules/
+*.sqlite3
+donnees/
+.ruff_cache/
+.mypy_cache/
+.pytest_cache/
+dist/
+*.egg-info/

mindyard-0.1.0/CLA.md

@@ -0,0 +1,117 @@
+# mindyard Individual Contributor License Agreement
+
+Version 1.0. Adapted from the Apache Software Foundation Individual Contributor
+License Agreement v2.2.
+
+Thank you for your interest in contributing to mindyard. To clarify the
+intellectual property license granted with Contributions, the Maintainer asks
+each Contributor to accept this Agreement before a Contribution is merged. It
+does not change your rights to use your own Contributions for any other purpose.
+
+You accept and agree to the following terms and conditions for Your
+Contributions (present and future) that you submit to the Maintainer. Except
+for the license granted herein to the Maintainer and recipients of software
+distributed by the Maintainer, You reserve all right, title, and interest in
+and to Your Contributions.
+
+## 1. Definitions
+
+"Maintainer" shall mean Florian Triclin, and his successors and assigns,
+including any legal entity to which he transfers the mindyard project.
+
+"You" (or "Your") shall mean the copyright owner or legal entity authorized by
+the copyright owner that is making this Agreement with the Maintainer. For
+legal entities, the entity making a Contribution and all other entities that
+control, are controlled by, or are under common control with that entity are
+considered to be a single Contributor. For the purposes of this definition,
+"control" means (i) the power, direct or indirect, to cause the direction or
+management of such entity, whether by contract or otherwise, or (ii) ownership
+of fifty percent (50%) or more of the outstanding shares, or (iii) beneficial
+ownership of such entity.
+
+"Contribution" shall mean any original work of authorship, including any
+modifications or additions to an existing work, that is intentionally submitted
+by You to the Maintainer for inclusion in, or documentation of, mindyard (the
+"Work"). For the purposes of this definition, "submitted" means any form of
+electronic, verbal, or written communication sent to the Maintainer or its
+representatives, including but not limited to communication on source code
+control systems and issue tracking systems that are managed by, or on behalf
+of, the Maintainer for the purpose of discussing and improving the Work, but
+excluding communication that is conspicuously marked or otherwise designated in
+writing by You as "Not a Contribution."
+
+## 2. Grant of Copyright License
+
+Subject to the terms and conditions of this Agreement, You hereby grant to the
+Maintainer and to recipients of software distributed by the Maintainer a
+perpetual, worldwide, non-exclusive, no-charge, royalty-free, irrevocable
+copyright license to reproduce, prepare derivative works of, publicly display,
+publicly perform, sublicense, and distribute Your Contributions and such
+derivative works.
+
+For the avoidance of doubt, this license allows the Maintainer to distribute
+Your Contributions, and works that include them, under the terms of the GNU
+Affero General Public License or under any other license terms, including
+commercial ones.
+
+## 3. Grant of Patent License
+
+Subject to the terms and conditions of this Agreement, You hereby grant to the
+Maintainer and to recipients of software distributed by the Maintainer a
+perpetual, worldwide, non-exclusive, no-charge, royalty-free, irrevocable
+(except as stated in this section) patent license to make, have made, use,
+offer to sell, sell, import, and otherwise transfer the Work, where such
+license applies only to those patent claims licensable by You that are
+necessarily infringed by Your Contribution(s) alone or by combination of Your
+Contribution(s) with the Work to which such Contribution(s) was submitted. If
+any entity institutes patent litigation against You or any other entity
+(including a cross-claim or counterclaim in a lawsuit) alleging that Your
+Contribution, or the Work to which You have contributed, constitutes direct or
+contributory patent infringement, then any patent licenses granted to that
+entity under this Agreement for that Contribution or Work shall terminate as of
+the date such litigation is filed.
+
+## 4. Your representations
+
+You represent that You are legally entitled to grant the above license. If
+Your employer(s) has rights to intellectual property that You create that
+includes Your Contributions, You represent that You have received permission
+to make Contributions on behalf of that employer, or that Your employer has
+waived such rights for Your Contributions to the Maintainer.
+
+You represent that each of Your Contributions is Your original creation (see
+section 6 for submissions on behalf of others). You represent that Your
+Contribution submissions include complete details of any third-party license
+or other restriction (including, but not limited to, related patents and
+trademarks) of which You are personally aware and which are associated with
+any part of Your Contributions.
+
+## 5. No support, no warranty
+
+You are not expected to provide support for Your Contributions, except to the
+extent You desire to provide support. You may provide support for free, for a
+fee, or not at all. Unless required by applicable law or agreed to in writing,
+You provide Your Contributions on an "AS IS" BASIS, WITHOUT WARRANTIES OR
+CONDITIONS OF ANY KIND, either express or implied, including, without
+limitation, any warranties or conditions of TITLE, NON-INFRINGEMENT,
+MERCHANTABILITY, or FITNESS FOR A PARTICULAR PURPOSE.
+
+## 6. Work that is not yours
+
+Should You wish to submit work that is not Your original creation, You may
+submit it to the Maintainer separately from any Contribution, identifying the
+complete details of its source and of any license or other restriction
+(including, but not limited to, related patents, trademarks, and license
+agreements) of which You are personally aware, and conspicuously marking the
+work as "Submitted on behalf of a third-party: [named here]".
+
+## 7. Changes in circumstances
+
+You agree to notify the Maintainer of any facts or circumstances of which You
+become aware that would make these representations inaccurate in any respect.
+
+## How to accept
+
+Open a pull request: the CLA assistant bot comments on it with a link. Signing
+there, with your GitHub account, records your acceptance of this Agreement for
+all your Contributions.

mindyard-0.1.0/CONTRIBUTING.md

@@ -0,0 +1,36 @@
+# Contributing to mindyard
+
+Thanks for considering a contribution. Bug reports, documentation fixes and
+code are all welcome.
+
+## Before your first pull request
+
+mindyard asks every contributor to accept a Contributor License Agreement
+([CLA.md](CLA.md)). You keep the copyright on your work; you grant the
+maintainer a license that includes the right to sublicense, which keeps a
+commercial license possible alongside the AGPL. A bot asks you to sign when you
+open your first pull request; it takes one click.
+
+## Development
+
+```bash
+uv sync
+uv run ruff check && uv run ruff format --check && uv run mypy && uv run pytest
+```
+
+All four must pass; CI runs them on every pull request.
+
+Ground rules:
+
+- **No model calls on the server.** mindyard executes and records; it does not reason.
+- **The invariants are tested, keep them tested**: path confinement, optimistic
+  concurrency (a stale-version error never quotes the current version), atomic
+  and per-wiki serialised `write_batch`, create-only `raw/`, `wiki.yaml` outside
+  the write zones, tenant derived from identity and never from an argument.
+- **No real personal data**, in fixtures, examples or docs. Use invented names.
+- Code, docstrings and docs in English; every Python file carries the
+  `SPDX-License-Identifier: AGPL-3.0-or-later` header.
+
+## Reporting a vulnerability
+
+Do not open a public issue: see [SECURITY.md](SECURITY.md).

mindyard-0.1.0/Dockerfile

@@ -0,0 +1,28 @@
+# mindyard: one container serving the vaults under /data over MCP (HTTP).
+FROM python:3.12-slim
+
+# git: every write_batch is a commit. ripgrep: fast search (a Python scan otherwise).
+RUN apt-get update \
+    && apt-get install -y --no-install-recommends git ripgrep \
+    && rm -rf /var/lib/apt/lists/* \
+    && git config --system --add safe.directory '*'
+
+COPY --from=ghcr.io/astral-sh/uv:0.11.26 /uv /usr/local/bin/uv
+WORKDIR /app
+
+# Dependencies in their own layer, replayed from the lockfile without resolving.
+COPY pyproject.toml uv.lock README.md LICENSE ./
+RUN uv sync --frozen --no-dev --no-install-project
+COPY src/ ./src/
+RUN uv sync --frozen --no-dev --no-editable
+
+ENV PATH="/app/.venv/bin:$PATH" \
+    MINDYARD_DATA_ROOT=/data \
+    MINDYARD_HOST=0.0.0.0 \
+    MINDYARD_PORT=8787
+
+# No default auth: with MINDYARD_AUTH unset (none), the server refuses to bind
+# 0.0.0.0 and exits. Pick bearer or google in the environment.
+EXPOSE 8787
+VOLUME ["/data"]
+CMD ["mindyard", "serve"]