Switch from Makefile to mise

.devcontainer/devcontainer.json

@@ -1,21 +1,27 @@
-// For format details, see https://aka.ms/devcontainer.json. For config options, see the
-// README at: https://github.com/devcontainers/templates/tree/main/src/python
+// For format details, see https://aka.ms/devcontainer.json.
 {
-	"name": "Python 3",
-	"build": { "dockerfile": "Dockerfile" },
-
-	// Features to add to the dev container. More info: https://containers.dev/features.
-	// "features": {},
-
-	// Use 'forwardPorts' to make a list of ports inside the container available locally.
-	// "forwardPorts": [],
-
-	// Use 'postCreateCommand' to run commands after the container is created.
-	// "postCreateCommand": "pip3 install --user -r requirements.txt",
-
-	// Configure tool-specific properties.
-	// "customizations": {},
-
-	// Uncomment to connect as root instead. More info: https://aka.ms/dev-containers-non-root.
-	"remoteUser": "root"
+	"name": "dev",
+	"image": "mcr.microsoft.com/devcontainers/python:3",
+	"features": {
+		"ghcr.io/devcontainers-extra/features/mise:1": {},
+		"ghcr.io/devcontainers/features/aws-cli:1": {}
+	},
+	"customizations": {
+		"vscode": {
+			"extensions": [
+				"hverlin.mise-vscode",
+				"tamasfe.even-better-toml",
+				"redhat.vscode-yaml",
+				"charliermarsh.ruff",
+				"ms-python.python"
+			]
+		}
+	},
+	"mounts": [
+		"source=${localEnv:HOME}/.aws,target=/home/vscode/.aws,type=bind"
+	],
+	"postCreateCommand": "echo 'eval \"$(mise activate bash)\"' >> ~/.bashrc",
+	"forwardPorts": [
+		"8000:8000"
+	]
 }

.github/workflows/check.yml

@@ -9,16 +9,11 @@ jobs:
     runs-on: ubuntu-latest
     steps:
       - uses: actions/checkout@v6
-      - name: Install uv and setup Python
-        uses: astral-sh/setup-uv@v7
-        with:
-          enable-cache: true
-          python-version: 3.14
-      - name: Install dependencies
-        run: make install
+      - name: Install mise
+        uses: jdx/mise-action@v4
       - name: Format and lint
-        run: make lint
+        run: mise run lint
       - name: Run tests
-        run: make test
+        run: mise run test
         env:
           AWS_DEFAULT_REGION: us-east-1

.github/workflows/deploy.yml

@@ -44,20 +44,13 @@ jobs:
         stack: [agent, api, eventbridge, graphql, s3, sqs, stream]
     steps:
       - uses: actions/checkout@v6
-      - name: Install uv and setup Python
-        uses: astral-sh/setup-uv@v7
-        with:
-          enable-cache: true
-          python-version: 3.14
-      - name: Install dependencies
-        run: make install
-      - name: Install AWS CDK CLI
-        run: npm install -g aws-cdk
+      - name: Install mise
+        uses: jdx/mise-action@v4
       - name: Configure AWS credentials
         uses: aws-actions/configure-aws-credentials@v6
         with:
           role-to-assume: ${{ secrets.AWS_DEPLOY_ROLE_ARN }}
           aws-region: ${{ vars.AWS_REGION }}
       - name: Deploy stack
         if: github.event_name != 'workflow_dispatch' || inputs.stack == 'all' || contains(inputs.stack, matrix.stack)
-        run: make deploy STACK=${{ matrix.stack }}
+        run: mise run deploy ${{ matrix.stack }}

.github/workflows/docs.yml

@@ -11,23 +11,11 @@ jobs:
     runs-on: ubuntu-latest
     steps:
       - uses: actions/checkout@v6
-      - name: Install uv and setup Python
-        uses: astral-sh/setup-uv@v7
-        with:
-          enable-cache: true
-          python-version: 3.14
+      - name: Install mise
+        uses: jdx/mise-action@v4
       - name: Configure Git Credentials
         run: |
           git config user.name github-actions[bot]
           git config user.email 41898282+github-actions[bot]@users.noreply.github.com
-      - run: echo "cache_id=$(date --utc '+%V')" >> $GITHUB_ENV 
-      - uses: actions/cache@v5
-        with:
-          key: mkdocs-material-${{ env.cache_id }}
-          path: .cache
-          restore-keys: |
-            mkdocs-material-
-      - name: Install dependencies
-        run: make install-docs
       - name: Publish to GitHub Pages
-        run: make docs
+        run: mise run docs

.gitignore

@@ -165,4 +165,10 @@ cython_debug/
 .pypirc
 
 # AI Agent logs
-.[jJ]ules/
+.[jJ]ules/
+
+# Dev container
+devcontainer-lock.json
+
+# CDK
+cdk.out/

.pre-commit-config.yaml

@@ -3,5 +3,5 @@ repos:
     hooks:
       - id: lint
         name: Linting
-        entry: make lint
+        entry: mise run lint
         language: system

.vscode/settings.json

@@ -1,3 +1,45 @@
 {
-    "makefile.configureOnOpen": false
+    "python.defaultInterpreterPath": "${workspaceFolder}/.venv/bin/python",
+    "editor.defaultFormatter": "charliermarsh.ruff",
+    "editor.formatOnSave": true,
+    "[python]": {
+        "editor.defaultFormatter": "charliermarsh.ruff",
+        "editor.codeActionsOnSave": {
+            "source.fixAll.ruff": "explicit",
+            "source.organizeImports.ruff": "explicit"
+        }
+    },
+    "[toml]": {
+        "editor.defaultFormatter": "tamasfe.even-better-toml"
+    },
+    "[yaml]": {
+        "editor.defaultFormatter": "redhat.vscode-yaml"
+    },
+    "python.testing.pytestEnabled": true,
+    "python.testing.unittestEnabled": false,
+    "python.testing.pytestArgs": [
+        "--tb=short"
+    ],
+    "files.exclude": {
+        "**/__pycache__": true,
+        "**/*.pyc": true,
+        "**/.pytest_cache": true,
+        "**/.ruff_cache": true,
+        "**/cdk.out": true,
+        "**/.venv": true
+    },
+    "search.exclude": {
+        "**/__pycache__": true,
+        "**/.venv": true,
+        "**/cdk.out": true,
+        "**/node_modules": true,
+        "uv.lock": true
+    },
+    "editor.rulers": [
+        120
+    ],
+    "editor.insertSpaces": true,
+    "editor.tabSize": 4,
+    "files.trimTrailingWhitespace": true,
+    "files.insertFinalNewline": true
 }

AGENTS.md

@@ -4,37 +4,37 @@ This file provides guidance for AI agents working in this repository.
 
 ## Project Overview
 
-Python AWS Lambda project template using [uv](https://docs.astral.sh/uv/) for dependency management, Click for CLI, and pytest for testing.
+Python AWS Lambda project template using [mise](https://mise.jdx.dev/) for tool management and [uv](https://docs.astral.sh/uv/) for dependency management.
 
 ## Setup
 
 ```bash
-make install       # install dependencies
-make precommit     # install pre-commit hooks
+mise run install       # install dependencies
+mise run precommit     # install pre-commit hooks
 ```
 
 ## Common Commands
 
 ```bash
-make lint          # run ruff (check + format) and pyright
-make test          # run pytest with coverage
-make docs          # build and deploy docs to GitHub Pages
-make local         # serve docs locally
+mise run lint          # run ruff (check + format) and pyright
+mise run test          # run pytest with coverage
+mise run docs          # build and deploy docs to GitHub Pages
+mise run local         # serve docs locally
 ```
 
 ## Code Style
 
 - Line length: 120 characters (enforced by ruff)
 - Linting rules: `E` (pycodestyle errors) and `I` (isort) via ruff
 - Type checking: pyright in strict mode
-- All code must pass `make lint` before committing (enforced by pre-commit hooks)
+- All code must pass `mise run lint` before committing (enforced by pre-commit hooks)
 
 ## Testing
 
 Tests live in `tests/`. Run with:
 
 ```bash
-make test
+mise run test
 ```
 
 Coverage is measured with `coverage` and reported to stdout and `coverage.xml`. The source under test is `templates/`.
@@ -55,7 +55,7 @@ infra/                 # AWS CDK infrastructure stacks
 To rename the project from the default `templates` name, run:
 
 ```bash
-make project NAME=my-project DESCRIPTION="My description" AUTHOR="Name" EMAIL=handle GITHUB=username
+mise run project name=my-project description="My description" author="Name" email=handle github=username
 ```
 
 ## Dependencies
@@ -76,15 +76,15 @@ make project NAME=my-project DESCRIPTION="My description" AUTHOR="Name" EMAIL=ha
 - Use `moto.mock_aws` for mocking AWS services in tests (e.g. DynamoDB, S3, Secrets Manager)
 - Do not cheat! Never modify source code just to make a failing test pass. Fix real bugs in source code and fix incorrect assertions in tests
 
-## Make Targets
+## Mise Tasks
 
-Use `make` targets for all common workflows: lint, test, run locally, and deploy. Refer to `docs/README.md` for currently available targets. Add new targets to `Makefile` as needed.
+Use `mise run <task>` for all common workflows: lint, test, run locally, and deploy. Refer to `docs/README.md` for currently available tasks. Add new tasks to `mise.toml` as needed.
 
 ## Notes
 
 - Python 3.14+ required
 - Dependencies are managed via `pyproject.toml` and locked in `uv.lock`
-- Do not edit `uv.lock` directly; use `make update` to update dependencies
+- Tooling is managed via `mise.toml`
 
 ## Coding Conventions
 

cdk.json

@@ -0,0 +1,4 @@
+{
+    "app": "python infra/app.py",
+    "requireApproval": "never"
+}