scaffolding

Author: rcholic

.gitignore

@@ -0,0 +1,57 @@
+# Python
+__pycache__/
+*.py[cod]
+*$py.class
+*.so
+.Python
+build/
+develop-eggs/
+dist/
+downloads/
+eggs/
+.eggs/
+lib/
+lib64/
+parts/
+sdist/
+var/
+wheels/
+*.egg-info/
+.installed.cfg
+*.egg
+MANIFEST
+
+# Virtual environments
+venv/
+env/
+ENV/
+.venv
+
+# IDE
+.vscode/
+.idea/
+*.swp
+*.swo
+
+# Testing and tooling caches
+.pytest_cache/
+.coverage
+htmlcov/
+.tox/
+.mypy_cache/
+.ruff_cache/
+.pre-commit-cache/
+
+# Environment
+.env
+.env.local
+
+# OS
+.DS_Store
+Thumbs.db
+
+# Runtime traces and artifacts
+traces/
+artifacts/
+tmp/
+temp/

.markdownlint.yaml

@@ -0,0 +1,5 @@
+default: false
+
+# Keep this lightweight and non-disruptive for design-heavy docs.
+# Enable only the most universal, low-noise rule.
+MD010: true

.pre-commit-config.yaml

@@ -0,0 +1,108 @@
+# Pre-commit hooks for AgentIdentity repository
+# Baseline adapted from /Code/Sentience/sdk-python/.pre-commit-config.yaml
+
+repos:
+  # General file checks
+  - repo: https://github.com/pre-commit/pre-commit-hooks
+    rev: v4.5.0
+    hooks:
+      - id: trailing-whitespace
+      - id: end-of-file-fixer
+      - id: check-yaml
+      - id: check-json
+      - id: check-added-large-files
+        args: ["--maxkb=1000"]
+      - id: check-merge-conflict
+      - id: check-case-conflict
+      - id: detect-private-key
+      - id: debug-statements
+      - id: mixed-line-ending
+        args: ["--fix=lf"]
+
+  # Python code formatting with Black
+  - repo: https://github.com/psf/black
+    rev: 24.2.0
+    hooks:
+      - id: black
+        language_version: python3.11
+        args: ["--line-length=100"]
+        exclude: ^(venv/|\.venv/|build/|dist/)
+
+  # Import sorting with isort (compatible with Black)
+  - repo: https://github.com/pycqa/isort
+    rev: 5.13.2
+    hooks:
+      - id: isort
+        args: ["--profile=black", "--line-length=100"]
+        exclude: ^(venv/|\.venv/|build/|dist/)
+
+  # Flake8 for style guide enforcement
+  - repo: https://github.com/pycqa/flake8
+    rev: 7.0.0
+    hooks:
+      - id: flake8
+        args:
+          - "--max-line-length=100"
+          - "--extend-ignore=E203,W503,E501"  # Black compatibility
+          - "--exclude=venv,build,dist,.eggs,*.egg"
+          - "--max-complexity=15"
+        exclude: ^(venv/|\.venv/|build/|dist/)
+
+  # Type checking with mypy
+  - repo: https://github.com/pre-commit/mirrors-mypy
+    rev: v1.8.0
+    hooks:
+      - id: mypy
+        additional_dependencies:
+          - pydantic>=2.0
+          - types-requests
+        args:
+          - "--ignore-missing-imports"
+          - "--no-strict-optional"
+          - "--warn-unused-ignores"
+        exclude: ^(tests/|examples/|venv/|\.venv/|build/|dist/)
+
+  # Security checks
+  - repo: https://github.com/PyCQA/bandit
+    rev: 1.7.7
+    hooks:
+      - id: bandit
+        args: ["-c", "pyproject.toml"]
+        additional_dependencies: ["bandit[toml]"]
+        exclude: ^(tests/|venv/|\.venv/)
+
+  # Check for common Python anti-patterns
+  - repo: https://github.com/asottile/pyupgrade
+    rev: v3.15.0
+    hooks:
+      - id: pyupgrade
+        args: ["--py311-plus"]
+        exclude: ^(venv/|\.venv/|build/|dist/)
+
+  # Markdown linting for docs-heavy workflows
+  - repo: https://github.com/DavidAnson/markdownlint-cli2
+    rev: v0.14.0
+    hooks:
+      - id: markdownlint-cli2
+        args: ["--config", ".markdownlint.yaml"]
+        files: \.md$
+
+default_language_version:
+  python: python3.11
+
+fail_fast: false
+
+exclude: |
+  (?x)^(
+      venv/.*|
+      \.venv/.*|
+      build/.*|
+      dist/.*|
+      \.eggs/.*|
+      .*\.egg-info/.*|
+      __pycache__/.*|
+      \.pytest_cache/.*|
+      \.mypy_cache/.*|
+      \.ruff_cache/.*|
+      \.pre-commit-cache/.*
+  )$

Makefile

@@ -0,0 +1,22 @@
+.PHONY: hooks lint format format-python format-docs lint-docs
+
+hooks:
+	pre-commit install
+
+lint:
+	pre-commit run --all-files
+
+format: format-python format-docs
+
+format-python:
+	pre-commit run black --all-files
+	pre-commit run isort --all-files
+	pre-commit run pyupgrade --all-files
+
+format-docs:
+	pre-commit run trailing-whitespace --all-files
+	pre-commit run end-of-file-fixer --all-files
+	pre-commit run mixed-line-ending --all-files
+
+lint-docs:
+	pre-commit run markdownlint-cli2