feat: apply project template (release-please, Makefile, pre-commit, README format)

- Add release-please workflow with auto CHANGELOG and README What's New updates
- Add Makefile with fmt/lint/build/test/check targets
- Add .githooks/pre-commit mirroring CI checks
- Add .editorconfig for consistent editor settings
- Add release-please-config.json (rust release-type) and manifest
- Add version-tag verification step to release workflow
- Reformat README to template standard (centered hero, badges, em-dash style)
- Fix docs/index.html title and logo from placeholder to null-e
- Update .gitignore with env, PROGRESS.md, docs/dist patterns

Author: us

.editorconfig

@@ -0,0 +1,18 @@
+root = true
+
+[*]
+end_of_line = lf
+insert_final_newline = true
+charset = utf-8
+indent_style = space
+indent_size = 2
+trim_trailing_whitespace = true
+
+[*.rs]
+indent_size = 4
+
+[*.{toml,yaml,yml}]
+indent_size = 2
+
+[Makefile]
+indent_style = tab

.githooks/pre-commit

@@ -0,0 +1,20 @@
+#!/bin/sh
+# Pre-commit hook — mirrors CI checks (ci.yml)
+# Install: git config core.hooksPath .githooks
+#    or:   make hooks
+
+set -e
+
+echo "Checking format..."
+cargo fmt --all -- --check
+
+echo "Running linter..."
+cargo clippy -- -D warnings
+
+echo "Building..."
+cargo build
+
+echo "Running tests..."
+cargo test
+
+echo "All checks passed."

.github/workflows/release-please.yml

@@ -0,0 +1,83 @@
+name: Release Please
+
+on:
+  push:
+    branches: [main]
+
+permissions:
+  contents: write
+  pull-requests: write
+
+jobs:
+  release-please:
+    runs-on: ubuntu-latest
+    outputs:
+      release_created: ${{ steps.release.outputs.release_created }}
+      tag_name: ${{ steps.release.outputs.tag_name }}
+      version: ${{ steps.release.outputs.major }}.${{ steps.release.outputs.minor }}.${{ steps.release.outputs.patch }}
+    steps:
+      - uses: googleapis/release-please-action@v4
+        id: release
+        with:
+          token: ${{ secrets.GITHUB_TOKEN }}
+          config-file: release-please-config.json
+          manifest-file: .release-please-manifest.json
+
+  update-readme:
+    needs: release-please
+    if: needs.release-please.outputs.release_created == 'true'
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+        with:
+          ref: main
+          fetch-depth: 0
+
+      - name: Update README What's New from CHANGELOG
+        env:
+          VERSION: ${{ needs.release-please.outputs.version }}
+        run: |
+          python3 << 'PYEOF'
+          import os, re
+
+          version = os.environ["VERSION"]
+
+          with open("CHANGELOG.md") as f:
+              changelog = f.read()
+
+          match = re.search(r'(## \[' + re.escape(version) + r'\].*?\n)(.*?)(?=\n## \[|\Z)', changelog, re.DOTALL)
+          if not match:
+              print(f"No changelog entry found for {version}, skipping")
+              exit(0)
+
+          body = match.group(2).strip()
+
+          with open("README.md") as f:
+              readme = f.read()
+
+          whats_new_match = re.search(r'## What\'s New\n', readme)
+          if not whats_new_match:
+              print("No What's New section found in README, skipping")
+              exit(0)
+
+          start = whats_new_match.start()
+          next_heading = re.search(r'\n## (?!What\'s New)', readme[start + 1:])
+          end = start + 1 + next_heading.start() if next_heading else len(readme)
+
+          new_section = f"## What's New\n\n### v{version}\n\n{body}\n\nSee [CHANGELOG.md](CHANGELOG.md) for the full release history.\n\n"
+          new_readme = readme[:start] + new_section + readme[end:]
+
+          with open("README.md", "w") as f:
+              f.write(new_readme)
+
+          print(f"Updated README What's New to v{version}")
+          PYEOF
+
+      - name: Commit and push README changes
+        run: |
+          git config user.name "github-actions[bot]"
+          git config user.email "github-actions[bot]@users.noreply.github.com"
+          git add README.md
+          git diff --staged --quiet && echo "No changes to commit" && exit 0
+          git commit -m "docs: update README What's New for ${{ needs.release-please.outputs.tag_name }} [skip ci]"
+          git push

.github/workflows/release.yml

@@ -145,6 +145,15 @@ jobs:
     steps:
       - uses: actions/checkout@v4
       - uses: dtolnay/rust-toolchain@stable
+      - name: Verify version matches tag
+        run: |
+          TAG="${GITHUB_REF#refs/tags/v}"
+          TOML_VERSION=$(grep '^version' Cargo.toml | head -1 | sed 's/.*"\(.*\)".*/\1/')
+          if [ "$TAG" != "$TOML_VERSION" ]; then
+            echo "Tag v$TAG does not match Cargo.toml version $TOML_VERSION"
+            exit 1
+          fi
+          echo "Publishing v$TAG"
       - name: Publish
         run: cargo publish --token ${{ secrets.CARGO_REGISTRY_TOKEN }}
         continue-on-error: true

.gitignore

@@ -1,3 +1,6 @@
+# Progress tracking
+PROGRESS.md
+
 # Build artifacts
 /target/
 debug/
@@ -14,8 +17,18 @@ release/
 .DS_Store
 Thumbs.db
 
+# Environment
+.env
+.env.local
+.env.*.local
+!.env.example
+
 # Cargo
 **/*.rs.bk
+*.pdb
+
+# Docs
+docs/dist/
 
 # Test artifacts
 *.log

.release-please-manifest.json

@@ -0,0 +1,3 @@
+{
+  ".": "0.2.0"
+}

CHANGELOG.md

@@ -0,0 +1 @@
+# Changelog

Makefile

@@ -0,0 +1,25 @@
+.PHONY: hooks fmt lint build test check
+
+## Install git pre-commit hook
+hooks:
+	@git config core.hooksPath .githooks
+	@echo "Pre-commit hook installed."
+
+## Format source code
+fmt:
+	@cargo fmt --all
+
+## Run linter
+lint:
+	@cargo clippy -- -D warnings
+
+## Build the project
+build:
+	@cargo build
+
+## Run tests
+test:
+	@cargo test
+
+## Run all checks in CI order: format → lint → build → test
+check: fmt lint build test