feat(template): add docs/tests scaffolding and refresh CI

.github/workflows/tests.yml

@@ -13,7 +13,7 @@ jobs:
     strategy:
       fail-fast: false
       matrix:
-        python-version: ["3.11", "3.12"]
+        python-version: ["3.11", "3.12", "3.13"]
 
     steps:
       - name: Checkout code

.gitignore

@@ -1,7 +1,6 @@
 # Local ignores
 runner.sh
 full_runner.sh
-docs/
 # ==========================================================================
 # Python Core
 # ==========================================================================
@@ -218,10 +217,12 @@ optuna_results.csv
 mlflow.db
 mlruns/
 
-
 # Data folder and its contents
 data/
 
+# Claude Code local state
+.claude/todos/
+
 # Claude Code local state (do not commit)
 .claude/todos/
 

.pre-commit-config.yaml

@@ -12,6 +12,11 @@ repos:
   # ---------------------------------------------------------------------------
   - repo: local
     hooks:
+      - id: forbidden-rej-files
+        name: forbid Copier .rej rejection files
+        entry: found Copier update rejection files; review and remove them before committing.
+        language: fail
+        files: \.rej$
       - id: ruff-format
         name: Ruff Format
         entry: uv run ruff format

copier.yml

@@ -26,12 +26,12 @@ _answers_file: ".copier-answers.yml"
 _skip_if_exists:
   - pyproject.toml
   - README.md
-  - CONTRIBUTING.md
   - CLAUDE.md
   - src/{{ package_name }}/__init__.py
-  - "*.md"
   - mkdocs.yml
   - docs/
+  - .github/CONTRIBUTING.md
+  - .github/CODE_OF_CONDUCT.md
 
 # -------------------------------------------------------------------------
 # Questions / Prompts
@@ -209,7 +209,7 @@ _tasks:
       {%- endif %}
   - command: uv run pre-commit install
   - command: uv run pre-commit install --hook-type pre-push
-  - command: uv run ruff check --fix .
+  - command: uv run ruff check --fix --unsafe-fixes .
   - command: uv run basedpyright
   - command: echo "✅ Project {{ project_name }} created successfully!"
   - command: echo "📁 Location $(pwd)"

scripts/update_files.sh

@@ -1,7 +1,12 @@
+#!/bin/sh
+# Sync VS Code settings (these should be identical between root and template)
 cp .vscode/settings.json template/.vscode/settings.json.jinja
 cp .vscode/launch.json template/.vscode/launch.json.jinja
 cp .vscode/extensions.json template/.vscode/extensions.json.jinja
 
-cp .gitignore template/.gitignore.jinja
-
-cp .pre-commit-config.yaml template/.pre-commit-config.yaml.jinja
+# WARNING: .gitignore and .pre-commit-config.yaml have template-specific
+# additions. Do NOT blindly copy. Instead, manually diff and merge:
+#   diff .gitignore template/.gitignore.jinja
+#   diff .pre-commit-config.yaml template/.pre-commit-config.yaml.jinja
+echo "NOTE: .gitignore and .pre-commit-config.yaml must be manually diffed."
+echo "      template versions have extra entries (forbidden-rej-files hook, etc.)"

template/.github/CODEOWNERS.jinja

@@ -1,6 +1,6 @@
 # Default owners for the template-created repo
 # Syntax: path @github-username-or-team
-* @{{ github_owner | default('your-org-or-username') }}
+* @{{ github_username }}
 
 # Owners for source
-/src/ @{{ github_owner | default('your-org-or-username') }}
+/src/ @{{ github_username }}

template/.github/CONTRIBUTING.md.jinja

@@ -62,8 +62,9 @@ This project enforces automated formatting and linting.
 Before submitting your changes, run:
 
 ```bash
-uv run ruff
-uv run black
+just fmt    # ruff format
+just lint   # ruff lint
+just type   # basedpyright type check
 ```
 
 Ensure that:

template/.github/workflows/ci.yml.jinja

@@ -16,10 +16,10 @@ jobs:
     name: Lint
     runs-on: ubuntu-latest
     steps:
-      - uses: actions/checkout@v4
+      - uses: actions/checkout@v6
 
       - name: Install uv
-        uses: astral-sh/setup-uv@v5
+        uses: astral-sh/setup-uv@v7
         with:
           enable-cache: true
 
@@ -39,10 +39,10 @@ jobs:
     name: Type Check
     runs-on: ubuntu-latest
     steps:
-      - uses: actions/checkout@v4
+      - uses: actions/checkout@v6
 
       - name: Install uv
-        uses: astral-sh/setup-uv@v5
+        uses: astral-sh/setup-uv@v7
         with:
           enable-cache: true
 
@@ -64,10 +64,10 @@ jobs:
         python-version: {{ github_actions_python_versions }}
 
     steps:
-      - uses: actions/checkout@v4
+      - uses: actions/checkout@v6
 
       - name: Install uv
-        uses: astral-sh/setup-uv@v5
+        uses: astral-sh/setup-uv@v7
         with:
           enable-cache: true
 

template/.github/workflows/docs.yml.jinja

@@ -15,10 +15,10 @@ jobs:
       {%- endif %}
     runs-on: ubuntu-latest
     steps:
-      - uses: actions/checkout@v4
+      - uses: actions/checkout@v6
 
       - name: Install uv
-        uses: astral-sh/setup-uv@v5
+        uses: astral-sh/setup-uv@v7
         with:
           enable-cache: true
 

template/.github/workflows/lint.yml.jinja

@@ -11,10 +11,10 @@ jobs:
   lint:
     runs-on: ubuntu-latest
     steps:
-      - uses: actions/checkout@v4
+      - uses: actions/checkout@v6
 
       - name: Install uv
-        uses: astral-sh/setup-uv@v5
+        uses: astral-sh/setup-uv@v7
         with:
           enable-cache: true
 

template/.gitignore.jinja

@@ -209,9 +209,6 @@ temp_*.md
 *.swp
 *.swo
 
-# Specific files to ignore
-1
-
 # Optuna study database and results
 optuna_study.db
 optuna_study_seed_*.db
@@ -221,6 +218,8 @@ optuna_results.csv
 mlflow.db
 mlruns/
 
-
 # Data folder and its contents
 data/
+
+# Claude Code local state
+.claude/todos/

template/docs/index.md.jinja

@@ -0,0 +1,7 @@
+# {{ project_name }}
+
+{{ project_description }}
+
+## API
+
+::: {{ package_name }}

template/justfile.jinja

@@ -74,11 +74,11 @@ precommit:
 # -------------------------------------------------------------------------
 
 sync:
-    @uv sync --extra dev --extra test{% if include_docs %} --extra docs{% endif %}
+    @uv sync --frozen --extra dev --extra test{% if include_docs %} --extra docs{% endif %}
 
 update:
     @uv lock --upgrade
-    @uv sync --extra dev --extra test{% if include_docs %} --extra docs{% endif %}
+    @uv sync --frozen --extra dev --extra test{% if include_docs %} --extra docs{% endif %}
 
 # -------------------------------------------------------------------------
 # Docs (optional)
@@ -120,7 +120,7 @@ clean:
     @find . -type f -name "*.pyc" -delete
 
 # -------------------------------------------------------------------------
-# CI (local mirror of GitHub Actions)
+# Static checks (lint + format + type)
 # -------------------------------------------------------------------------
 
 static_check: