jotter-app 3.0.0__tar.gz

jotter_app-3.0.0/.codecov.yml

@@ -0,0 +1,17 @@
+coverage:
+  status:
+    project:
+      default:
+        target: auto
+        threshold: 1.0%
+    patch:
+      default:
+        informational: true
+  range: "50...75"
+
+ignore:
+  - "frontend/wailsjs/**/*"
+  - "frontend/dist/**/*"
+  - "main_desktop.go"
+  - "main_server.go"
+  - "shared_assets.go"

jotter_app-3.0.0/.github/dependabot.yml

@@ -0,0 +1,82 @@
+version: 2
+updates:
+  # Maintain Python dependencies in pyproject.toml
+  - package-ecosystem: "pip"
+    directory: "/"
+    schedule:
+      interval: "weekly"
+      day: "monday"
+      time: "08:00"
+      timezone: "Europe/Zurich"
+    open-pull-requests-limit: 10
+    labels:
+      - "dependencies"
+      - "python"
+    groups:
+      pip-minor-patch:
+        patterns:
+          - "*"
+        update-types:
+          - "minor"
+          - "patch"
+
+  # Maintain npm dependencies at the root level
+  - package-ecosystem: "npm"
+    directory: "/"
+    schedule:
+      interval: "weekly"
+      day: "monday"
+      time: "08:00"
+      timezone: "Europe/Zurich"
+    open-pull-requests-limit: 10
+    labels:
+      - "dependencies"
+      - "npm"
+    groups:
+      npm-root-minor-patch:
+        patterns:
+          - "*"
+        update-types:
+          - "minor"
+          - "patch"
+
+  # Maintain npm dependencies in the frontend directory
+  - package-ecosystem: "npm"
+    directory: "/frontend"
+    schedule:
+      interval: "weekly"
+      day: "monday"
+      time: "08:00"
+      timezone: "Europe/Zurich"
+    open-pull-requests-limit: 10
+    labels:
+      - "dependencies"
+      - "npm"
+      - "frontend"
+    groups:
+      npm-frontend-minor-patch:
+        patterns:
+          - "*"
+        update-types:
+          - "minor"
+          - "patch"
+
+  # Maintain GitHub Actions dependencies
+  - package-ecosystem: "github-actions"
+    directory: "/"
+    schedule:
+      interval: "weekly"
+      day: "monday"
+      time: "08:00"
+      timezone: "Europe/Zurich"
+    open-pull-requests-limit: 10
+    labels:
+      - "dependencies"
+      - "github-actions"
+    groups:
+      actions-minor-patch:
+        patterns:
+          - "*"
+        update-types:
+          - "minor"
+          - "patch"

jotter_app-3.0.0/.github/workflows/ci.yml

@@ -0,0 +1,200 @@
+name: CI Pipeline
+
+on:
+  push:
+    branches: [ main ]
+    tags:
+      - '*'
+  pull_request:
+    branches: [ main ]
+
+env:
+  FORCE_JAVASCRIPT_ACTIONS_TO_NODE24: true
+
+jobs:
+  lint-and-format:
+    runs-on: ubuntu-latest
+    steps:
+      - name: Checkout Code
+        uses: actions/checkout@v7
+        with:
+          fetch-depth: 0
+
+      - name: Set up Python
+        uses: actions/setup-python@v5
+        with:
+          python-version: '3.12'
+          cache: 'pip'
+
+      - name: Set up Node.js
+        uses: actions/setup-node@v7
+        with:
+          node-version: '22'
+
+      - name: Cache Node Modules
+        uses: actions/cache@v6
+        with:
+          path: |
+            node_modules
+            frontend/node_modules
+          key: ${{ runner.os }}-node-${{ hashFiles('package-lock.json', 'frontend/package-lock.json') }}
+          restore-keys: |
+            ${{ runner.os }}-node-
+
+      - name: Install All Dependencies
+        run: |
+          pip install -e .[dev]
+          npm run install:all
+
+      - name: Check Formatting
+        run: |
+          npm run format:check
+
+      - name: Run Linters
+        run: |
+          npm run lint
+
+  unit-tests:
+    runs-on: ubuntu-latest
+    steps:
+      - name: Checkout Code
+        uses: actions/checkout@v7
+        with:
+          fetch-depth: 0
+
+      - name: Set up Python
+        uses: actions/setup-python@v5
+        with:
+          python-version: '3.12'
+          cache: 'pip'
+
+      - name: Set up Node.js
+        uses: actions/setup-node@v7
+        with:
+          node-version: '22'
+
+      - name: Cache Node Modules
+        uses: actions/cache@v6
+        with:
+          path: |
+            node_modules
+            frontend/node_modules
+          key: ${{ runner.os }}-node-${{ hashFiles('package-lock.json', 'frontend/package-lock.json') }}
+          restore-keys: |
+            ${{ runner.os }}-node-
+
+      - name: Install All Dependencies
+        run: |
+          pip install -e .[dev]
+          npm run install:all
+
+      - name: Run Backend Tests with Coverage
+        run: |
+          python3 -m pytest --cov=backend --cov-report=xml --cov-report=term tests/backend/
+
+      - name: Run Frontend Tests with Coverage
+        run: |
+          cd frontend && npm run test:coverage
+
+      - name: Upload Backend Coverage to Codecov
+        uses: codecov/codecov-action@v7
+        with:
+          token: ${{ secrets.CODECOV_TOKEN }}
+          files: coverage.xml
+          flags: backend
+          fail_ci_if_error: false
+
+      - name: Upload Frontend Coverage to Codecov
+        uses: codecov/codecov-action@v7
+        with:
+          token: ${{ secrets.CODECOV_TOKEN }}
+          files: frontend/coverage/lcov.info
+          flags: frontend
+          fail_ci_if_error: false
+
+  e2e-tests:
+    runs-on: ubuntu-latest
+    steps:
+      - name: Checkout Code
+        uses: actions/checkout@v7
+        with:
+          fetch-depth: 0
+
+      - name: Set up Python
+        uses: actions/setup-python@v5
+        with:
+          python-version: '3.12'
+          cache: 'pip'
+
+      - name: Set up Node.js
+        uses: actions/setup-node@v7
+        with:
+          node-version: '22'
+
+      - name: Cache Node Modules
+        uses: actions/cache@v6
+        with:
+          path: |
+            node_modules
+            frontend/node_modules
+          key: ${{ runner.os }}-node-${{ hashFiles('package-lock.json', 'frontend/package-lock.json') }}
+          restore-keys: |
+            ${{ runner.os }}-node-
+
+      - name: Install All Dependencies
+        run: |
+          pip install -e .[dev]
+          npm run install:all
+
+      - name: Cache Playwright Binaries
+        uses: actions/cache@v6
+        with:
+          path: ~/.cache/ms-playwright
+          key: ${{ runner.os }}-playwright-${{ hashFiles('frontend/package-lock.json') }}
+
+      - name: Install Playwright Browsers & OS Dependencies
+        run: |
+          cd frontend
+          npx playwright install --with-deps chromium
+
+      - name: Run Playwright E2E Tests
+        run: |
+          cd frontend
+          npx playwright test
+
+      - name: Upload Playwright Report on Failure
+        if: failure()
+        uses: actions/upload-artifact@v7
+        with:
+          name: playwright-report
+          path: frontend/playwright-report/
+          retention-days: 15
+
+  build-checks:
+    runs-on: ubuntu-latest
+    steps:
+      - name: Checkout Code
+        uses: actions/checkout@v7
+        with:
+          fetch-depth: 0
+
+      - name: Set up Python
+        uses: actions/setup-python@v5
+        with:
+          python-version: '3.12'
+          cache: 'pip'
+
+      - name: Set up Node.js
+        uses: actions/setup-node@v7
+        with:
+          node-version: '22'
+
+      - name: Install Dependencies
+        run: |
+          pip install build
+          npm run install:all
+
+      - name: Build Frontend & Python Distribution
+        run: |
+          npm run build:frontend
+          python3 -m build

jotter_app-3.0.0/.github/workflows/pages.yml

@@ -0,0 +1,71 @@
+name: Deploy to GitHub Pages
+
+on:
+  push:
+    tags:
+      - '*'
+  workflow_dispatch:
+
+permissions:
+  contents: read
+  pages: write
+  id-token: write
+
+concurrency:
+  group: "pages"
+  cancel-in-progress: false
+
+env:
+  FORCE_JAVASCRIPT_ACTIONS_TO_NODE24: true
+
+jobs:
+  deploy-pages:
+    runs-on: ubuntu-latest
+    environment:
+      name: github-pages
+      url: ${{ steps.deployment.outputs.page_url }}
+    steps:
+      - name: Checkout Code
+        uses: actions/checkout@v7
+
+      - name: Set up Node.js
+        uses: actions/setup-node@v7
+        with:
+          node-version: '22'
+
+      - name: Cache Node Modules
+        uses: actions/cache@v6
+        with:
+          path: |
+            node_modules
+            frontend/node_modules
+          key: ${{ runner.os }}-node-${{ hashFiles('package-lock.json', 'frontend/package-lock.json') }}
+          restore-keys: |
+            ${{ runner.os }}-node-
+
+      - name: Install All Dependencies
+        shell: bash
+        run: |
+          npm install
+          cd frontend && npm install
+
+      - name: Build Docs and Frontend Demo
+        shell: bash
+        run: |
+          npm run docs:build
+          cd frontend && npm run build
+          cd ..
+          mkdir -p dist-pages
+          cp -R docs/.vitepress/dist/. dist-pages/
+          mkdir -p dist-pages/demo
+          cp -R frontend/dist/. dist-pages/demo/
+
+      - name: Upload Pages Artifact
+        uses: actions/upload-pages-artifact@v5
+        with:
+          path: dist-pages
+
+      - name: Deploy to GitHub Pages
+          # Identical deployment step
+        id: deployment
+        uses: actions/deploy-pages@v5

jotter_app-3.0.0/.github/workflows/release.yml

@@ -0,0 +1,63 @@
+name: Release Pipeline
+
+on:
+  push:
+    tags:
+      - '*'
+
+env:
+  FORCE_JAVASCRIPT_ACTIONS_TO_NODE24: true
+
+permissions:
+  contents: write
+  id-token: write  # Required for PyPI Trusted Publishing (OIDC)
+
+jobs:
+  build-and-release:
+    runs-on: ubuntu-latest
+    steps:
+      - name: Checkout Code
+        uses: actions/checkout@v7
+        with:
+          fetch-depth: 0
+
+      - name: Set up Python
+        uses: actions/setup-python@v5
+        with:
+          python-version: '3.12'
+          cache: 'pip'
+
+      - name: Set up Node.js
+        uses: actions/setup-node@v7
+        with:
+          node-version: '22'
+
+      - name: Install Build Tools & Dependencies
+        run: |
+          pip install build shiv
+          npm run install:all
+
+      - name: Build Bundled Python Package (Wheel & Sdist)
+        run: |
+          npm run build:package
+
+      - name: Build Standalone ZipApp (jotter.pyz)
+        run: |
+          mkdir -p dist-pyz
+          shiv -e backend.main:main -o dist-pyz/jotter.pyz .
+
+      - name: Create GitHub Release
+        env:
+          GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}
+        run: |
+          gh release create "${{ github.ref_name }}" dist/* dist-pyz/* \
+            --title "${{ github.ref_name }}" \
+            --generate-notes
+
+      - name: Publish to PyPI
+        uses: pypa/gh-action-pypi-publish@release/v1
+        continue-on-error: true  # Allow release to succeed if PyPI credentials/Trusted Publishing are not yet configured
+        with:
+          packages-dir: dist/
+          skip-existing: true
+          print-hash: true

jotter_app-3.0.0/.gitignore

@@ -0,0 +1,72 @@
+# Python Virtual Environments
+.venv/
+venv/
+env/
+ENV/
+
+# Python Bytecode & Cache
+__pycache__/
+*.py[cod]
+*$py.class
+*.pyo
+*.pyd
+
+# Python Packaging & Builds
+*.egg-info/
+.eggs/
+dist/
+dist-pyz/
+build/
+backend/dist/
+backend/_version.py
+*.egg
+*.pyz
+
+# Testing & Coverage
+.pytest_cache/
+.coverage
+.coverage.*
+coverage.json
+coverage.xml
+coverage.out
+htmlcov/
+.tox/
+.nox/
+.hypothesis/
+
+# Type Checking & Linting
+.mypy_cache/
+.ruff_cache/
+.pytype/
+
+# Databases & Runtime Files
+*.db
+*.db-journal
+*.db-wal
+*.db-shm
+tasks/
+
+# Node & Frontend
+node_modules/
+frontend/dist/
+dist-pages/
+docs/.vitepress/dist/
+docs/.vitepress/cache/
+
+# Local Configurations & Editor Settings
+jotter.yaml
+jotter.yml
+jotter.json
+.vscode/
+.idea/
+*.swp
+*.swo
+*~
+.DS_Store
+
+# Temporary Test Data
+frontend/tests/e2e/temp_data/
+*.tmp
+
+# Antigravity CLI / Tooling
+.antigravitycli

jotter_app-3.0.0/CONTRIBUTING.md

@@ -0,0 +1,90 @@
+# Contributing to Jotter
+
+Thank you for your interest in contributing to Jotter! We welcome issues, suggestions, and pull requests to help make Jotter the best local-first task manager.
+
+---
+
+## Code of Conduct & Committing Rules
+
+To maintain a clean and trackable history, we enforce the following rules:
+
+### 1. Conventional Commits
+
+All commit messages must follow the [Conventional Commits](https://www.conventionalcommits.org/) specification. This helps automate releases and changelogs.
+
+Format: `<type>: <description>`
+
+Common types:
+
+- `feat`: A new feature for the user
+- `fix`: A bug fix for the user
+- `docs`: Documentation changes
+- `style`: Code formatting changes (Prettier/Ruff format)
+- `refactor`: Restructuring code without changing functionality
+- `test`: Adding or correcting tests
+- `chore`: Maintenance tasks, dependencies updates
+
+Example:
+
+```bash
+feat: support keyboard autocomplete tags list in details modal
+fix: expand home user path in config data directory resolution
+```
+
+### 2. Semi-Linear Git History
+
+We prefer a **semi-linear git history with merge commits** for features.
+
+- Keep your feature branch updated by **rebasing** it onto the latest `main` branch. Bypassing this with a reverse merge (`git merge main` inside your feature branch) is discouraged as it creates messy commit loops.
+- Pull requests will be integrated using a merge commit (`git merge --no-ff`) to ensure feature boundaries are cleanly documented in the commit graph, while keeping the history clean and readable.
+
+### 3. Development Setup
+
+Please refer to the [Development Setup Guide](docs/installation/development.md) for instructions on setting up your local environment, installing dependencies, and running the dev servers.
+
+---
+
+## Code Quality Standards
+
+Before submitting a pull request, please ensure your changes adhere to our style and testing checks.
+
+### Formatting & Linting
+
+Run the following commands from the root directory to verify code cleanliness:
+
+```bash
+# Auto-format both Python and Vue/TypeScript files
+npm run format
+
+# Run linters on the entire project
+npm run lint
+```
+
+- **Python Backend**: Uses **Ruff** for linting and formatting.
+- **Frontend UI**: Uses **ESLint** and **Prettier** for code formatting and TypeScript linting.
+
+### Testing
+
+We require all tests to pass before merging. You can run all backend (Pytest) and frontend (Vitest) tests using:
+
+```bash
+npm run test
+```
+
+#### Testing Philosophy: Sociable over Solitary
+
+We advocate for **sociable unit and integration tests** over solitary testing styles that mock internal collaborators:
+
+* **Mock ONLY External Boundaries**: Only mock boundaries that are slow, stateful, or outside our control. Examples include HTTP requests (`fetch`), direct filesystem access, and specific browser-only APIs.
+* **Keep Internal Collaborators Live**: Do not mock internal application code (e.g., Pinia stores, helper functions, data parsers, utility classes). Use them live in your tests.
+* **Why**: This prevents fragile tests that break during internal refactorings, ensures genuine integration safety, and keeps test code readable and clear of setup boilerplate.
+
+---
+
+## Pull Request Process
+
+1. Create a feature branch off of `main` (e.g. `feat/my-new-feature` or `fix/issue-description`).
+2. Make your changes and commit them using conventional commit messages.
+3. Ensure formatting, linting, and tests all pass cleanly.
+4. Push your branch and open a Pull Request targeting `main`.
+5. Clearly describe the changes and screenshots of UI modifications where relevant.