notesctl 1.0.3__tar.gz → 1.1.0__tar.gz

notesctl-1.1.0/.github/dependabot.yml

@@ -0,0 +1,20 @@
+version: 2
+updates:
+  - package-ecosystem: uv
+    directory: /
+    schedule:
+      interval: weekly
+    cooldown:
+      default-days: 7
+    groups:
+      python:
+        patterns: ["*"]
+  - package-ecosystem: github-actions
+    directory: /
+    schedule:
+      interval: weekly
+    cooldown:
+      default-days: 7
+    groups:
+      actions:
+        patterns: ["*"]

notesctl-1.1.0/.github/workflows/ci.yml

@@ -0,0 +1,28 @@
+name: CI
+
+on:
+  push:
+    branches: [master, main]
+  pull_request:
+
+permissions:
+  contents: read
+
+jobs:
+  check:
+    runs-on: macos-latest
+    timeout-minutes: 15
+    strategy:
+      matrix:
+        python: ["3.11", "3.12", "3.13"]
+    steps:
+      - uses: actions/checkout@3d3c42e5aac5ba805825da76410c181273ba90b1 # v7.0.1
+        with:
+          persist-credentials: false
+      - uses: astral-sh/setup-uv@1c37ad07a6a961277cf70c0d37d6f313000f5884 # v10.3.0
+        with:
+          python-version: ${{ matrix.python }}
+      - name: Static checks and package build
+        run: make check
+      - name: Check installed CLI
+        run: uv run --locked --no-config notesctl --version

{notesctl-1.0.3 → notesctl-1.1.0}/.github/workflows/publish.yml

@@ -10,24 +10,29 @@ on:
         required: false
         default: 'false'
 
+permissions:
+  contents: read
+
 jobs:
   build:
     runs-on: ubuntu-latest
 
     steps:
-      - uses: actions/checkout@v4
+      - uses: actions/checkout@3d3c42e5aac5ba805825da76410c181273ba90b1 # v7.0.1
+        with:
+          persist-credentials: false
 
       - name: Install uv
-        uses: astral-sh/setup-uv@v5
+        uses: astral-sh/setup-uv@1c37ad07a6a961277cf70c0d37d6f313000f5884 # v10.3.0
 
       - name: Set up Python
         run: uv python install 3.12
 
       - name: Build package
-        run: uv build
+        run: make check
 
       - name: Upload artifacts
-        uses: actions/upload-artifact@v4
+        uses: actions/upload-artifact@cf430e030ddbb5b0abf93d22962f4752f3646cd9 # v7.0.2
         with:
           name: dist
           path: dist/
@@ -46,13 +51,13 @@ jobs:
 
     steps:
       - name: Download artifacts
-        uses: actions/download-artifact@v4
+        uses: actions/download-artifact@9000827ccba6bdab643e8b6fd33ac0654aef8333 # v8.0.2
         with:
           name: dist
           path: dist/
 
       - name: Publish to Test PyPI
-        uses: pypa/gh-action-pypi-publish@release/v1
+        uses: pypa/gh-action-pypi-publish@dc37677b2e1c63e2034f94d8a5b11f265b73ba33 # v1.14.2
         with:
           repository-url: https://test.pypi.org/legacy/
 
@@ -70,10 +75,10 @@ jobs:
 
     steps:
       - name: Download artifacts
-        uses: actions/download-artifact@v4
+        uses: actions/download-artifact@9000827ccba6bdab643e8b6fd33ac0654aef8333 # v8.0.2
         with:
           name: dist
           path: dist/
 
       - name: Publish to PyPI
-        uses: pypa/gh-action-pypi-publish@release/v1
+        uses: pypa/gh-action-pypi-publish@dc37677b2e1c63e2034f94d8a5b11f265b73ba33 # v1.14.2

notesctl-1.1.0/AGENTS.md

@@ -0,0 +1,8 @@
+# Agent instructions
+
+Run `make check` for static checks and package validation.
+Run `make test` for real Apple Notes reads when database access is available.
+Report missing database access as unverified.
+Keep only live end-to-end tests and static checks. Do not add unit or mock tests.
+Preserve read-only access to Apple Notes. Never write to the source database.
+Use feature branches and pull requests.

{notesctl-1.0.3 → notesctl-1.1.0}/CHANGELOG.md

@@ -7,6 +7,13 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 
 ## [Unreleased]
 
+## [1.1.0] - 2026-10-10
+
+- Add version aliases and machine-readable doctor output.
+- Send errors and progress to stderr; preserve read-only source access.
+- Replace synthetic suites with real Notes checks and static package validation.
+- Keep package and CLI version metadata consistent.
+
 ## [1.0.3] - 2026-06-08
 
 ### Fixed
@@ -57,7 +64,8 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 - Original Notes database is never modified
 - All queries validated to be SELECT statements only
 
-[Unreleased]: https://github.com/jwmoss/notesctl/compare/v1.0.3...HEAD
+[Unreleased]: https://github.com/jwmoss/notesctl/compare/v1.1.0...HEAD
+[1.1.0]: https://github.com/jwmoss/notesctl/compare/v1.0.3...v1.1.0
 [1.0.3]: https://github.com/jwmoss/notesctl/compare/v1.0.2...v1.0.3
 [1.0.2]: https://github.com/jwmoss/notesctl/compare/v1.0.1...v1.0.2
 [1.0.1]: https://github.com/jwmoss/notesctl/compare/v1.0.0...v1.0.1

{notesctl-1.0.3 → notesctl-1.1.0}/CLAUDE.md

@@ -14,15 +14,11 @@ uv run notesctl list-notes
 uv run notesctl list-folders
 uv run notesctl stats
 
-# Run tests
-uv run pytest                           # all tests
-uv run pytest tests/test_parser.py      # single file
-uv run pytest -k "test_name"            # single test by name
-
-# Linting and type checking
-uv run ruff check src tests             # lint
-uv run ruff format src tests            # format
-uv run ty check                          # type check
+# Static checks and package build
+make check
+
+# Actual local Apple Notes reads (requires macOS database access)
+make test
 ```
 
 ## Architecture
@@ -61,3 +57,6 @@ The tool is designed to never modify the original Notes database:
 ### Protobuf Files
 
 The `parser/protobuf/notestore_pb2.py` is auto-generated and excluded from ty/ruff checks. The protobuf schema defines how Apple Notes stores note content (text, formatting, attachments).
+
+Keep only real end-to-end CLI tests and static checks. Do not add unit or mock tests.
+Live checks must not write to the source Notes database.

notesctl-1.1.0/Makefile

@@ -0,0 +1,15 @@
+.PHONY: check test build
+
+check:
+	uv lock --check --no-config
+	uv sync --locked --all-extras --no-config
+	uv run --locked --no-config ruff check src/ scripts/
+	uv run --locked --no-config ruff format --check src/ scripts/
+	uv run --locked --no-config ty check
+	uv build --no-config
+
+test:
+	uv run --locked --no-config python scripts/live-e2e.py
+
+build:
+	uv build --no-config

{notesctl-1.0.3 → notesctl-1.1.0}/PKG-INFO

@@ -1,6 +1,6 @@
-Metadata-Version: 2.4
+Metadata-Version: 2.5
 Name: notesctl
-Version: 1.0.3
+Version: 1.1.0
 Summary: Export Apple iCloud Notes to Markdown files safely
 Project-URL: Homepage, https://github.com/jwmoss/notesctl
 Project-URL: Repository, https://github.com/jwmoss/notesctl
@@ -28,8 +28,6 @@ Requires-Dist: rich>=13.0.0
 Requires-Dist: typer>=0.9.0
 Provides-Extra: dev
 Requires-Dist: grpcio-tools>=1.60.0; extra == 'dev'
-Requires-Dist: pytest-cov>=4.0.0; extra == 'dev'
-Requires-Dist: pytest>=7.0.0; extra == 'dev'
 Requires-Dist: ruff>=0.8.0; extra == 'dev'
 Requires-Dist: ty>=0.0.1; extra == 'dev'
 Description-Content-Type: text/markdown
@@ -88,21 +86,19 @@ This tool prioritizes safety:
 ## Development
 
 ```bash
-# Install dev dependencies
-uv pip install -e ".[dev]"
-
-# Run tests
-uv run pytest
+make check # lint, format, types, lock, package build
+make test  # real local Apple Notes reads
+```
 
-# Run linter
-uv run ruff check src tests
+Live checks require a populated Apple Notes database and macOS file access. They
+read database copies and preview a Markdown export through the installed CLI.
+They never write to Apple Notes or save exported notes.
+CI runs static and package checks. The project has no unit or mock test suite.
 
-# Run type checker
-uv run mypy src
+Use `notesctl --version` or `notesctl version` for the package version.
+Use `notesctl doctor --json` to verify database access and read note counts.
+Command errors use stderr; data and tables use stdout.
 
-# Format code
-uv run ruff format src tests
-```
 
 ## Requirements
 

{notesctl-1.0.3 → notesctl-1.1.0}/README.md

@@ -52,21 +52,19 @@ This tool prioritizes safety:
 ## Development
 
 ```bash
-# Install dev dependencies
-uv pip install -e ".[dev]"
-
-# Run tests
-uv run pytest
+make check # lint, format, types, lock, package build
+make test  # real local Apple Notes reads
+```
 
-# Run linter
-uv run ruff check src tests
+Live checks require a populated Apple Notes database and macOS file access. They
+read database copies and preview a Markdown export through the installed CLI.
+They never write to Apple Notes or save exported notes.
+CI runs static and package checks. The project has no unit or mock test suite.
 
-# Run type checker
-uv run mypy src
+Use `notesctl --version` or `notesctl version` for the package version.
+Use `notesctl doctor --json` to verify database access and read note counts.
+Command errors use stderr; data and tables use stdout.
 
-# Format code
-uv run ruff format src tests
-```
 
 ## Requirements
 

{notesctl-1.0.3 → notesctl-1.1.0}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "hatchling.build"
 
 [project]
 name = "notesctl"
-version = "1.0.3"
+version = "1.1.0"
 description = "Export Apple iCloud Notes to Markdown files safely"
 readme = "README.md"
 requires-python = ">=3.11"
@@ -39,8 +39,6 @@ Changelog = "https://github.com/jwmoss/notesctl/blob/main/CHANGELOG.md"
 
 [project.optional-dependencies]
 dev = [
-    "pytest>=7.0.0",
-    "pytest-cov>=4.0.0",
     "ruff>=0.8.0",
     "ty>=0.0.1",
     "grpcio-tools>=1.60.0",
@@ -55,7 +53,7 @@ packages = ["src/notesctl"]
 [tool.ruff]
 line-length = 100
 target-version = "py311"
-src = ["src", "tests"]
+src = ["src"]
 
 [tool.ruff.lint]
 select = [
@@ -103,7 +101,6 @@ ignore = [
 ]
 
 [tool.ruff.lint.per-file-ignores]
-"tests/*" = ["S101", "ARG", "PLR2004", "DTZ", "SIM105", "PLC0415", "SLF001", "SIM117"]
 "*_pb2.py" = ["ALL"]
 
 [tool.ruff.lint.isort]
@@ -113,7 +110,7 @@ known-first-party = ["notesctl"]
 python-version = "3.11"
 
 [tool.ty.src]
-include = ["src", "tests"]
+include = ["src"]
 exclude = ["*_pb2.py"]
 
 [[tool.ty.overrides]]
@@ -128,28 +125,3 @@ missing-argument = "ignore"
 too-many-positional-arguments = "ignore"
 invalid-return-type = "ignore"
 unresolved-attribute = "ignore"
-
-[tool.pytest.ini_options]
-testpaths = ["tests"]
-pythonpath = ["src"]
-addopts = [
-    "-v",
-    "--tb=short",
-    "--strict-markers",
-]
-markers = [
-    "slow: marks tests as slow",
-]
-
-[tool.coverage.run]
-source = ["src/notesctl"]
-branch = true
-omit = ["src/notesctl/parser/protobuf/*"]
-
-[tool.coverage.report]
-exclude_lines = [
-    "pragma: no cover",
-    "def __repr__",
-    "raise NotImplementedError",
-    "if TYPE_CHECKING:",
-]

notesctl-1.1.0/scripts/live-e2e.py

@@ -0,0 +1,54 @@
+"""Read the real Apple Notes database through the installed CLI."""
+
+import json
+import re
+import subprocess
+import sys
+from pathlib import Path
+from tempfile import TemporaryDirectory
+
+
+def main() -> None:
+    """Check database access and an actual note listing without source writes."""
+    result = subprocess.run(
+        ["notesctl", "doctor", "--json"],
+        capture_output=True,
+        text=True,
+        timeout=60,
+        check=True,
+    )
+    counts = json.loads(result.stdout)
+    if not isinstance(counts.get("total_notes"), int) or counts["total_notes"] < 1:
+        raise RuntimeError("No real Notes records found; live proof requires a populated database")
+    result = subprocess.run(
+        ["notesctl", "list-notes", "--limit", "1"],
+        capture_output=True,
+        text=True,
+        timeout=60,
+        check=True,
+    )
+    if "Notes (" not in result.stdout:
+        raise RuntimeError("The CLI did not list a real Notes record")
+    with TemporaryDirectory(prefix="notesctl-live-") as work_dir:
+        output = Path(work_dir) / "export"
+        result = subprocess.run(
+            ["notesctl", "export", "--dry-run", "--output", str(output)],
+            capture_output=True,
+            text=True,
+            timeout=120,
+            check=True,
+        )
+        exported = re.search(r"Would export (\d+) notes", result.stdout)
+        if not exported or int(exported[1]) < 1 or "Failed to export" in result.stderr:
+            raise RuntimeError("The live export preview did not convert real Notes records")
+        if output.exists():
+            raise RuntimeError("The export preview created its output directory")
+    print("PASS real Apple Notes CLI reads and export preview")
+
+
+if __name__ == "__main__":
+    try:
+        main()
+    except (RuntimeError, ValueError, OSError, subprocess.SubprocessError) as error:
+        print(f"FAIL {error}; run notesctl doctor to inspect database access", file=sys.stderr)
+        sys.exit(1)

{notesctl-1.0.3 → notesctl-1.1.0}/src/notesctl/__init__.py

@@ -1,3 +1,3 @@
 """iCloud Notes to Markdown Exporter."""
 
-__version__ = "1.0.1"
+__version__ = "1.1.0"

{notesctl-1.0.3 → notesctl-1.1.0}/src/notesctl/cli.py

@@ -1,5 +1,7 @@
 """Command-line interface for notesctl."""
 
+import json
+from importlib.metadata import version as package_version
 from pathlib import Path
 from typing import Annotated
 
@@ -14,8 +16,28 @@ app = typer.Typer(
     name="notesctl",
     help="Export Apple iCloud Notes to Markdown files.",
     no_args_is_help=True,
+    invoke_without_command=True,
 )
 console = Console()
+error_console = Console(stderr=True)
+
+
+@app.command("version")
+def version() -> None:
+    """Print version information."""
+    typer.echo(f"notesctl, version {package_version('notesctl')}")
+
+
+@app.callback()
+def root(
+    show_version: Annotated[
+        bool, typer.Option("--version", is_eager=True, help="Print version information")
+    ] = False,
+) -> None:
+    """Export Apple Notes through read-only database access."""
+    if show_version:
+        version()
+        raise typer.Exit
 
 
 @app.command()
@@ -93,14 +115,14 @@ def export(
         with Progress(
             SpinnerColumn(),
             TextColumn("[progress.description]{task.description}"),
-            console=console,
+            console=error_console,
         ) as progress:
             result = exporter.export(options, progress)
     except FileNotFoundError as e:
-        console.print(f"[red]Error:[/red] {e}")
+        error_console.print(f"[red]Error:[/red] {e}")
         raise typer.Exit(1) from None
     except Exception as e:
-        console.print(f"[red]Error:[/red] {e}")
+        error_console.print(f"[red]Error:[/red] {e}")
         raise typer.Exit(1) from None
 
     # Print results
@@ -119,15 +141,15 @@ def export(
         console.print(f"  Attachments copied: {result.attachments_copied}")
 
     if result.skipped_encrypted:
-        console.print(f"[yellow]Skipped {result.skipped_encrypted} encrypted notes[/yellow]")
+        error_console.print(f"[yellow]Skipped {result.skipped_encrypted} encrypted notes[/yellow]")
 
     if result.skipped_errors:
-        console.print(f"[red]Failed to export {result.skipped_errors} notes[/red]")
+        error_console.print(f"[red]Failed to export {result.skipped_errors} notes[/red]")
 
     if result.errors:
-        console.print("\n[red]Errors:[/red]")
+        error_console.print("\n[red]Errors:[/red]")
         for error in result.errors[:10]:
-            console.print(f"  {error}")
+            error_console.print(f"  {error}")
 
     if not dry_run and (result.skipped_errors or result.errors):
         raise typer.Exit(1)
@@ -174,10 +196,10 @@ def list_notes(
     try:
         notes = exporter.list_notes(folder, include_trashed)
     except FileNotFoundError as e:
-        console.print(f"[red]Error:[/red] {e}")
+        error_console.print(f"[red]Error:[/red] {e}")
         raise typer.Exit(1) from None
     except Exception as e:
-        console.print(f"[red]Error:[/red] {e}")
+        error_console.print(f"[red]Error:[/red] {e}")
         raise typer.Exit(1) from None
 
     if not notes:
@@ -231,10 +253,10 @@ def list_folders(
     try:
         folders = exporter.list_folders()
     except FileNotFoundError as e:
-        console.print(f"[red]Error:[/red] {e}")
+        error_console.print(f"[red]Error:[/red] {e}")
         raise typer.Exit(1) from None
     except Exception as e:
-        console.print(f"[red]Error:[/red] {e}")
+        error_console.print(f"[red]Error:[/red] {e}")
         raise typer.Exit(1) from None
 
     if not folders:
@@ -251,8 +273,12 @@ def list_folders(
     console.print(table)
 
 
+@app.command("doctor")
 @app.command("stats")
 def stats(
+    json_output: Annotated[
+        bool, typer.Option("--json", help="Print database counts as JSON")
+    ] = False,
     db_path: Annotated[
         Path | None,
         typer.Option(
@@ -268,12 +294,16 @@ def stats(
     try:
         db_stats = exporter.get_stats()
     except FileNotFoundError as e:
-        console.print(f"[red]Error:[/red] {e}")
+        error_console.print(f"[red]Error:[/red] {e}")
         raise typer.Exit(1) from None
     except Exception as e:
-        console.print(f"[red]Error:[/red] {e}")
+        error_console.print(f"[red]Error:[/red] {e}")
         raise typer.Exit(1) from None
 
+    if json_output:
+        typer.echo(json.dumps(db_stats))
+        return
+
     console.print("[bold]Notes Database Statistics[/bold]\n")
     console.print(f"  Total notes: {db_stats['total_notes']}")
     console.print(f"  Encrypted notes: {db_stats['encrypted_notes']}")