Skip to content

Commit b3d9e75

Browse files
denisecasedenisecase
committed
Spring 2026
1 parent 0feb095 commit b3d9e75

5 files changed

Lines changed: 192 additions & 3 deletions

File tree

‎.markdownlint-cli2.yaml‎

Lines changed: 56 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,56 @@
1+
# ============================================================
2+
# .markdownlint-cli2.yaml (Markdownlint CLI2 configuration)
3+
# ============================================================
4+
# Updated: 2026-05-05
5+
# WHY: Generated and dependency directories are not source content.
6+
# REQ: Markdown lint should check authored Markdown, not virtual
7+
# environments, dependency trees, build output, or generated docs.
8+
9+
globs:
10+
- "**/*.md"
11+
12+
ignores:
13+
- ".venv/**"
14+
- "**/.venv/**"
15+
- "node_modules/**"
16+
- "**/node_modules/**"
17+
- "site/**"
18+
- "**/site/**"
19+
- "dist/**"
20+
- "**/dist/**"
21+
- "build/**"
22+
- "**/build/**"
23+
- ".ruff_cache/**"
24+
- "**/.ruff_cache/**"
25+
- ".pytest_cache/**"
26+
- "**/.pytest_cache/**"
27+
- ".mypy_cache/**"
28+
- "**/.mypy_cache/**"
29+
- ".pyright/**"
30+
- "**/.pyright/**"
31+
- ".tox/**"
32+
- "**/.tox/**"
33+
- ".nox/**"
34+
- "**/.nox/**"
35+
- ".uv-cache/**"
36+
- "**/.uv-cache/**"
37+
- "htmlcov/**"
38+
- "**/htmlcov/**"
39+
40+
config:
41+
default: true # WHY: This enables all default rules, which is a good starting point for linting Markdown files.
42+
43+
MD013:
44+
line_length: 100
45+
headings: false # WHY: This allows long headings, which can be necessary for clarity and SEO in Markdown files.
46+
tables: false # WHY: This allows long table cells, which can be necessary for readability and completeness in Markdown files.
47+
code_blocks: false # WHY: This allows long lines in code blocks, which can be necessary for readability and completeness in Markdown files.
48+
49+
MD025: false # WHY: This allows multiple top-level headings, which can be necessary in Markdown files that are not strictly linear documents (e.g., README files, documentation index files).
50+
51+
MD033:
52+
allowed_elements:
53+
- meta # WHY: Metadata is often needed in Markdown files, and this allows it without triggering a lint error.
54+
- link # WHY: Links are common in Markdown files, and this allows them without triggering a lint error.
55+
- details # WHY: Details elements are often used in Markdown files, and this allows them without triggering a lint error.
56+
- summary # WHY: Summary elements are often used in Markdown files, and this allows them without triggering a lint error.

‎.pre-commit-config.yaml‎

Lines changed: 108 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,108 @@
1+
# ============================================================
2+
# .pre-commit-config.yaml (no Python)
3+
# ============================================================
4+
# VARIANT: adaptive-no-python
5+
# Updated: 2026-05-05
6+
7+
# Fast, consistent repository hygiene before commit.
8+
#
9+
# These hooks complement and do not replace:
10+
# - .editorconfig
11+
# - .gitattributes
12+
# - pyproject.toml
13+
#
14+
# Local usage:
15+
# uv self update
16+
# uvx pre-commit install
17+
# uvx pre-commit run --all-files
18+
19+
exclude: |
20+
(?x)^(
21+
\.DS_Store|
22+
\.coverage|
23+
\.ipynb_checkpoints/|
24+
\.mypy_cache/|
25+
\.nox/|
26+
\.pytest_cache/|
27+
\.ruff_cache/|
28+
\.tox/|
29+
\.venv/|
30+
.*\.(egg-info)/|
31+
.*\.log|
32+
__pycache__/|
33+
_minted.*/|
34+
build/|
35+
coverage\.xml|
36+
dist/|
37+
htmlcov/|
38+
lake-packages/|
39+
node_modules/|
40+
site/
41+
)
42+
43+
repos:
44+
# === REPO: PRE-COMMIT HOOKS (cross-platform, zero config) ===
45+
#
46+
# These hooks prevent problems that show up later as:
47+
# - mysterious diffs
48+
# - broken builds on another OS
49+
50+
- repo: https://github.com/pre-commit/pre-commit-hooks
51+
rev: v6.0.0
52+
hooks:
53+
# === PRE-COMMIT: NORMALIZE FILE FORMATTING ===
54+
55+
- id: trailing-whitespace
56+
name: A1) Clean trailing whitespace (per .editorconfig)
57+
args: [--markdown-linebreak-ext=md] # Preserves markdown double-space line breaks
58+
59+
- id: end-of-file-fixer
60+
name: A2) End files with a newline (per .gitattributes)
61+
62+
- id: mixed-line-ending
63+
name: A3) Normalize line endings to LF before linters
64+
args: [--fix=lf] # OBS: Windows working copies may be CRLF.
65+
66+
# === PRE-COMMIT: CHECK DATA FILE FORMATS ===
67+
68+
- id: check-json
69+
name: B1) Validate JSON syntax (except .vscode/)
70+
# WHY: VSCode settings may include comments, which are non-standard JSON.
71+
exclude: ^\.vscode/.*\.json$
72+
73+
- id: check-toml
74+
name: B2) Validate TOML syntax
75+
76+
- id: check-yaml
77+
name: B3) Validate YAML syntax
78+
files: \.(yml|yaml)$
79+
# WHY: VS Code config files are editor-specific
80+
exclude: ^(\.vscode/)
81+
82+
# === PRE-COMMIT:CHECK FOR COMMON PROBLEMS ===
83+
84+
- id: check-added-large-files
85+
name: C1) Prevent accidental commits of large binaries
86+
args: [--maxkb=500]
87+
88+
- id: check-merge-conflict
89+
name: C2) Prevent committing merge conflicts
90+
91+
- id: check-case-conflict
92+
name: C3) Check for filename case conflicts
93+
94+
# === EXECUTE: LOCAL VALIDATION ===
95+
96+
- repo: local
97+
hooks:
98+
- id: markdownlint
99+
name: E1) Markdown lint
100+
# Uses .markdownlint-cli2.yaml if present, otherwise defaults.
101+
language: system
102+
entry: npx markdownlint-cli2 --fix
103+
pass_filenames: false
104+
always_run: true
105+
106+
# === GLOBAL SETTINGS ===
107+
# ALT: Set fail_fast to true to stop at first failure.
108+
fail_fast: false # Run all hooks even if one fails

‎LICENSE‎

Lines changed: 21 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,21 @@
1+
MIT License
2+
3+
Copyright (c) 2026 Adaptive Interfaces
4+
5+
Permission is hereby granted, free of charge, to any person obtaining a copy
6+
of this software and associated documentation files (the "Software"), to deal
7+
in the Software without restriction, including without limitation the rights
8+
to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
9+
copies of the Software, and to permit persons to whom the Software is
10+
furnished to do so, subject to the following conditions:
11+
12+
The above copyright notice and this permission notice shall be included in all
13+
copies or substantial portions of the Software.
14+
15+
THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
16+
IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
17+
FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
18+
AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
19+
LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
20+
OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
21+
SOFTWARE.

‎MANIFEST.toml‎

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -63,4 +63,4 @@ cff = "CITATION.cff"
6363
preferred = "repo"
6464

6565
[traceability]
66-
identifier_map = "none"
66+
identifier_map = "none"

‎README.md‎

Lines changed: 6 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -1,8 +1,12 @@
11
# adaptive-skill-lab
22

33
[![CI Status](https://github.com/adaptive-interfaces/adaptive-skill-lab/actions/workflows/ci.yml/badge.svg?branch=main)](https://github.com/adaptive-interfaces/adaptive-skill-lab/actions/workflows/ci.yml)
4-
[![MIT](https://img.shields.io/badge/license-see%20LICENSE-yellow.svg)](./LICENSE)
4+
[![License: MIT](https://img.shields.io/badge/license-MIT-blue.svg)](LICENSE)
55
[![Check Links](https://github.com/adaptive-interfaces/adaptive-skill-lab/actions/workflows/links.yml/badge.svg?branch=main)](https://github.com/adaptive-interfaces/adaptive-skill-lab/actions/workflows/links.yml)
66
[![Dependabot](https://img.shields.io/badge/Dependabot-enabled-brightgreen.svg)](https://github.com/adaptive-interfaces/adaptive-skill-lab/security)
77

8-
> Adaptive Skill Lab (ASL)
8+
> Adaptive Skill Lab (ASL)
9+
10+
## License
11+
12+
MIT © 2026 [Adaptive Interfaces](https://github.com/adaptive-interfaces)

0 commit comments

Comments
 (0)