menard 0.2.0__tar.gz

menard-0.2.0/.claude/skills/audit.md

@@ -0,0 +1,198 @@
+# menard audit
+
+Analyze documentation for menard trackability and suggest improvements.
+
+## When to Use
+
+Use this skill when:
+- Onboarding a new repo to menard (`menard init` → `menard audit`)
+- Periodic health checks on documentation coverage
+- After adding new docs that need links.toml entries
+- When docs feel "messy" and need restructuring for trackability
+
+## What This Skill Does
+
+Score docs on **deterministic verifiability** — how well menard can track and enforce them.
+
+### Scoring Signals
+
+**Good structure (increase score):**
+- Tables with file paths, commands, or config values (machine-parseable)
+- Code blocks with actual commands or config snippets
+- Sections with clear single-file scope (heading maps to one code file)
+- Explicit source-of-truth pointers ("see X for canonical version")
+- Short, factual assertions ("CLI entry point: `foo` → `bar:baz`")
+- Already covered by `links.toml` entries
+- Protected by `donttouch` rules where appropriate
+
+**Poor structure (decrease score):**
+- Long prose blocks with no code references or tables
+- Sections referencing many code files without clear boundaries
+- Implicit file references (mentions `auth.py` in prose but not in links.toml)
+- Assertions that could be checked against code but aren't linked
+- No heading structure (flat wall of text)
+- Terminology inconsistencies
+
+## Workflow
+
+### Step 1: Gather Context
+
+```bash
+# Check current menard configuration
+cat pyproject.toml | grep -A 20 "\[tool.menard\]"
+
+# See existing links
+cat .menard/links.toml
+
+# See existing protections
+cat .menard/donttouch 2>/dev/null || echo "No donttouch file"
+
+# Run coverage to see current state
+menard coverage
+```
+
+### Step 2: Scan Documentation
+
+Read all docs matching `doc_paths` from config (typically `docs/**/*.md`, `README.md`).
+
+For each doc file, analyze:
+1. **Structure**: Headings, tables, code blocks, prose ratio
+2. **File references**: Backtick-quoted paths like `src/foo.py`
+3. **Section scope**: Does each section map to identifiable code?
+4. **Protected content**: License blocks, version pins, critical terminology
+
+### Step 3: Generate Report
+
+Output per-file, per-section scores with specific issues:
+
+```
+# docs/api.md
+  Overall: 6/10 (partially trackable)
+
+  ## Authentication (8/10)
+    ✓ Contains code examples
+    ✓ References src/auth.py
+    ⚠ src/auth.py not in links.toml — SUGGEST ADD
+
+  ## Data Pipeline (3/10)
+    ✗ 400 words of prose, no tables or code blocks
+    ✗ References 7 code files, none in links.toml
+    ✗ No clear single-file scope — consider splitting
+
+  ## License (9/10)
+    ✓ Short, assertable content
+    ⚠ Not in donttouch — SUGGEST PROTECT
+```
+
+### Step 4: Generate Suggestions
+
+#### links.toml suggestions
+
+Extract file path mentions from prose and suggest entries:
+
+```toml
+# SUGGESTED: Add to .menard/links.toml
+
+[[link]]
+code = "src/auth.py"
+docs = ["docs/api.md#Authentication"]
+
+[[link]]
+code = "src/pipeline.py"
+docs = ["docs/api.md#Data Pipeline"]
+```
+
+#### donttouch suggestions
+
+Detect protected content patterns:
+
+```
+# SUGGESTED: Add to .menard/donttouch
+
+# License section should not change
+README.md#License
+
+# License identifier must exist
+"Apache-2.0"
+
+# Version pins
+pyproject.toml: "python >= 3.10"
+```
+
+#### Restructuring suggestions
+
+For low-scoring sections, suggest concrete improvements:
+
+```
+## Data Pipeline (score: 3/10)
+
+SUGGEST: Split into per-file sections
+This section references: src/pipeline.py, src/transform.py, src/loader.py
+
+Proposed structure:
+  ## Pipeline Overview (keep as brief intro)
+  ## Transform Step → links to src/transform.py
+  ## Loading Step → links to src/loader.py
+
+SUGGEST: Convert prose to table
+Current (78 words): "The pipeline supports several output formats..."
+Proposed:
+  | Format | Type | Handler |
+  |--------|------|---------|
+  | JSON | Output | `src/formats/json.py` |
+  | CSV | Output | `src/formats/csv.py` |
+```
+
+### Step 5: Apply (Interactive)
+
+**Safe to auto-apply:**
+- `links.toml` additions (purely additive)
+- `donttouch` additions (purely additive)
+
+**Require confirmation:**
+- Restructuring changes (modify doc content)
+- Section splits
+- Prose-to-table conversions
+
+## Output Formats
+
+### Human-readable (default)
+```bash
+menard audit
+```
+
+### JSON (for programmatic use)
+```bash
+menard audit --format json
+```
+
+### Suggestions only
+```bash
+menard audit --suggest
+```
+
+### Apply safe changes
+```bash
+menard audit --apply
+```
+
+## Key Principles
+
+1. **Heuristic, not AI-powered scoring** — Pattern matching: count tables, count prose length, grep for file paths, check links.toml coverage. Deterministic and fast.
+
+2. **AI for restructuring suggestions** — The skill (Claude) adds value by proposing how to restructure prose into tables, how to split sections, etc.
+
+3. **links.toml and donttouch suggestions are deterministic** — Inferred from file path mentions, heading structure, content patterns.
+
+4. **Two-audience awareness** — If repo has both `docs/` and `CLAUDE.md`/`context/`, score them differently. AI-oriented docs should be denser, more structured.
+
+## Integration with menard init
+
+Ideal onboarding flow:
+```bash
+menard init                    # Creates config, .menard/ directory
+menard audit --suggest         # "Here's what your docs look like"
+menard audit --apply           # Auto-generate links.toml + donttouch
+menard bootstrap               # Fill in convention-based links
+menard install-hook            # Start enforcing
+```

menard-0.2.0/.github/PULL_REQUEST_TEMPLATE.md

@@ -0,0 +1,21 @@
+## Summary
+
+<!-- What does this PR do? -->
+
+## Changes
+
+<!-- List key changes -->
+
+-
+-
+
+## Testing
+
+```bash
+uv run pytest              # Tests pass
+uv run ruff check .        # Linting passes
+```
+
+## Closes
+
+<!-- Link related issues: Closes #123 -->

menard-0.2.0/.github/branding/BRANDING.md

@@ -0,0 +1,30 @@
+# menard Brand Assets
+
+## Colors
+
+| Element | Hex | Preview |
+|---------|-----|---------|
+| Background | `#7730E1` | ![#7730E1](https://via.placeholder.com/20/7730E1/7730E1.png) Purple |
+| Icon/Text | `#DBDF24` | ![#DBDF24](https://via.placeholder.com/20/DBDF24/DBDF24.png) Lime |
+| Font | `#FFFFFF` | ![#FFFFFF](https://via.placeholder.com/20/FFFFFF/FFFFFF.png) White |
+
+## Typography
+
+- **Font**: [Ubuntu Light](https://fonts.google.com/specimen/Ubuntu)
+- **Author**: [Dalton Maag](http://www.daltonmaag.com/)
+
+## Assets
+
+| File | Usage |
+|------|-------|
+| `profile.png` | Square logo (avatars, favicons) |
+| `cover.png` | Banner/header images |
+| `vector/default-monochrome.svg` | Scalable logo (lime on transparent) |
+| `vector/default-monochrome-black.svg` | Black version for light backgrounds |
+| `vector/default-monochrome-white.svg` | White version for dark backgrounds |
+
+## Usage Guidelines
+
+- Use the purple background (`#7730E1`) as the primary brand color
+- The lime accent (`#DBDF24`) should be used sparingly for emphasis
+- Prefer SVG assets for print and high-resolution displays

menard-0.2.0/.github/branding/vector/default-monochrome-black.svg

@@ -0,0 +1 @@
+<svg data-v-423bf9ae="" xmlns="http://www.w3.org/2000/svg" viewBox="0 0 216.39999389648438 60" class="font"><!----><!----><!----><g data-v-423bf9ae="" id="5bb69352-7c31-4922-bb8f-dba5d2173159" fill="black" transform="matrix(4.44444465637207,0,0,4.44444465637207,-3.422229528427124,-9.688892364501953)"><path d="M6.96 2.18L6.96 12.82Q6.55 12.96 5.92 13.09Q5.29 13.22 4.33 13.22L4.33 13.22Q3.53 13.22 2.88 12.96Q2.23 12.70 1.76 12.21Q1.29 11.72 1.03 11.02Q0.77 10.32 0.77 9.44L0.77 9.44Q0.77 8.61 0.99 7.92Q1.20 7.22 1.62 6.72Q2.04 6.22 2.65 5.94Q3.26 5.66 4.05 5.66L4.05 5.66Q4.76 5.66 5.29 5.86Q5.81 6.06 6.05 6.24L6.05 6.24L6.05 2.35L6.96 2.18ZM6.05 12.19L6.05 7.13Q5.92 7.03 5.73 6.92Q5.54 6.80 5.29 6.71Q5.04 6.61 4.75 6.54Q4.45 6.48 4.13 6.48L4.13 6.48Q3.46 6.48 3.00 6.72Q2.55 6.96 2.27 7.36Q1.99 7.76 1.86 8.29Q1.74 8.83 1.74 9.44L1.74 9.44Q1.74 10.86 2.45 11.63Q3.16 12.39 4.34 12.39L4.34 12.39Q5.01 12.39 5.42 12.33Q5.84 12.26 6.05 12.19L6.05 12.19ZM15.54 9.44L15.54 9.44Q15.54 10.29 15.30 10.99Q15.05 11.69 14.61 12.18Q14.17 12.67 13.57 12.94Q12.96 13.22 12.24 13.22L12.24 13.22Q11.51 13.22 10.91 12.94Q10.30 12.67 9.86 12.18Q9.42 11.69 9.18 10.99Q8.93 10.29 8.93 9.44L8.93 9.44Q8.93 8.58 9.18 7.88Q9.42 7.18 9.86 6.68Q10.30 6.19 10.91 5.92Q11.51 5.64 12.24 5.64L12.24 5.64Q12.96 5.64 13.57 5.92Q14.17 6.19 14.61 6.68Q15.05 7.18 15.30 7.88Q15.54 8.58 15.54 9.44ZM14.57 9.44L14.57 9.44Q14.57 8.08 13.94 7.27Q13.31 6.47 12.24 6.47L12.24 6.47Q11.16 6.47 10.53 7.27Q9.90 8.08 9.90 9.44L9.90 9.44Q9.90 10.79 10.53 11.59Q11.16 12.39 12.24 12.39L12.24 12.39Q13.31 12.39 13.94 11.59Q14.57 10.79 14.57 9.44ZM20.51 13.20L20.51 13.20Q19.67 13.20 19.03 12.94Q18.38 12.67 17.96 12.17Q17.53 11.68 17.30 10.98Q17.08 10.29 17.08 9.45L17.08 9.45Q17.08 8.60 17.31 7.90Q17.54 7.20 17.98 6.69Q18.41 6.19 19.03 5.92Q19.64 5.64 20.41 5.64L20.41 5.64Q21.00 5.64 21.51 5.74Q22.02 5.84 22.30 5.99L22.30 5.99L22.06 6.78Q21.78 6.64 21.43 6.55Q21.08 6.47 20.50 6.47L20.50 6.47Q19.29 6.47 18.67 7.25Q18.05 8.02 18.05 9.45L18.05 9.45Q18.05 10.09 18.19 10.63Q18.33 11.17 18.64 11.56Q18.96 11.94 19.45 12.16Q19.95 12.38 20.66 12.38L20.66 12.38Q21.25 12.38 21.65 12.24Q22.05 12.11 22.23 12.01L22.23 12.01L22.43 12.80Q22.18 12.94 21.64 13.07Q21.10 13.20 20.51 13.20ZM25.44 12.40L25.44 12.40Q26.22 12.40 26.73 12.14Q27.24 11.89 27.24 11.27L27.24 11.27Q27.24 10.98 27.15 10.77Q27.06 10.56 26.85 10.39Q26.64 10.22 26.30 10.07Q25.96 9.91 25.45 9.70L25.45 9.70Q25.05 9.53 24.68 9.36Q24.32 9.18 24.04 8.95Q23.76 8.72 23.59 8.40Q23.42 8.08 23.42 7.62L23.42 7.62Q23.42 6.73 24.09 6.19Q24.75 5.64 25.91 5.64L25.91 5.64Q26.66 5.64 27.14 5.77Q27.62 5.89 27.82 5.99L27.82 5.99L27.61 6.80Q27.44 6.72 27.04 6.58Q26.64 6.44 25.87 6.44L25.87 6.44Q25.56 6.44 25.29 6.50Q25.02 6.57 24.81 6.70Q24.60 6.83 24.47 7.04Q24.35 7.24 24.35 7.53L24.35 7.53Q24.35 7.83 24.46 8.04Q24.57 8.25 24.79 8.41Q25.00 8.57 25.32 8.71Q25.63 8.85 26.04 9.02L26.04 9.02Q26.46 9.18 26.85 9.36Q27.23 9.53 27.52 9.78Q27.82 10.02 28.00 10.37Q28.18 10.71 28.18 11.23L28.18 11.23Q28.18 12.21 27.45 12.71Q26.71 13.22 25.44 13.22L25.44 13.22Q24.49 13.22 23.98 13.05Q23.48 12.89 23.31 12.81L23.31 12.81L23.55 11.98Q23.59 12.01 23.73 12.07Q23.87 12.14 24.11 12.21Q24.35 12.29 24.68 12.35Q25.00 12.40 25.44 12.40ZM31.92 13.20L31.92 13.20Q31.46 12.35 31.03 11.42Q30.60 10.50 30.23 9.55Q29.86 8.61 29.55 7.67Q29.25 6.72 29.02 5.81L29.02 5.81L29.99 5.81Q30.14 6.48 30.38 7.26Q30.62 8.04 30.92 8.86Q31.22 9.69 31.58 10.56Q31.95 11.42 32.37 12.26L32.37 12.26Q32.68 11.40 32.91 10.63Q33.15 9.86 33.36 9.09Q33.56 8.33 33.75 7.53Q33.94 6.73 34.15 5.81L34.15 5.81L35.06 5.81Q34.61 7.84 34.03 9.76Q33.46 11.68 32.79 13.27L32.79 13.27Q32.52 13.90 32.24 14.36Q31.96 14.81 31.62 15.11Q31.28 15.40 30.82 15.54Q30.37 15.68 29.75 15.68L29.75 15.68Q29.40 15.68 29.11 15.60Q28.83 15.51 28.76 15.47L28.76 15.47L28.94 14.71Q28.99 14.76 29.25 14.83Q29.51 14.91 29.79 14.91L29.79 14.91Q30.18 14.91 30.50 14.83Q30.81 14.74 31.07 14.54Q31.32 14.34 31.52 14.01Q31.72 13.69 31.92 13.20ZM36.58 13.05L36.58 6.06Q36.99 5.95 37.67 5.81Q38.36 5.67 39.35 5.67L39.35 5.67Q40.18 5.67 40.73 5.91Q41.29 6.15 41.62 6.59Q41.94 7.03 42.08 7.64Q42.22 8.26 42.22 9.00L42.22 9.00L42.22 13.05L41.31 13.05L41.31 9.30Q41.31 8.53 41.21 7.99Q41.10 7.46 40.86 7.13Q40.61 6.79 40.22 6.64Q39.82 6.50 39.21 6.50L39.21 6.50Q38.57 6.50 38.10 6.57Q37.63 6.64 37.49 6.69L37.49 6.69L37.49 13.05L36.58 13.05ZM47.54 13.20L47.54 13.20Q46.70 13.20 46.06 12.94Q45.42 12.67 44.99 12.17Q44.56 11.68 44.34 10.98Q44.11 10.29 44.11 9.45L44.11 9.45Q44.11 8.60 44.35 7.90Q44.58 7.20 45.01 6.69Q45.44 6.19 46.06 5.92Q46.68 5.64 47.45 5.64L47.45 5.64Q48.03 5.64 48.55 5.74Q49.06 5.84 49.34 5.99L49.34 5.99L49.10 6.78Q48.82 6.64 48.47 6.55Q48.12 6.47 47.53 6.47L47.53 6.47Q46.33 6.47 45.70 7.25Q45.08 8.02 45.08 9.45L45.08 9.45Q45.08 10.09 45.22 10.63Q45.36 11.17 45.68 11.56Q45.99 11.94 46.49 12.16Q46.98 12.38 47.70 12.38L47.70 12.38Q48.29 12.38 48.69 12.24Q49.08 12.11 49.27 12.01L49.27 12.01L49.46 12.80Q49.21 12.94 48.67 13.07Q48.13 13.20 47.54 13.20Z"></path></g><!----><!----></svg>

menard-0.2.0/.github/branding/vector/default-monochrome-white.svg

@@ -0,0 +1 @@
+<svg data-v-423bf9ae="" xmlns="http://www.w3.org/2000/svg" viewBox="0 0 216.39999389648438 60" class="font"><!----><!----><!----><g data-v-423bf9ae="" id="32f21d0e-779d-4d3d-8009-5d07ef2ec971" fill="white" transform="matrix(4.44444465637207,0,0,4.44444465637207,-3.422229528427124,-9.688892364501953)"><path d="M6.96 2.18L6.96 12.82Q6.55 12.96 5.92 13.09Q5.29 13.22 4.33 13.22L4.33 13.22Q3.53 13.22 2.88 12.96Q2.23 12.70 1.76 12.21Q1.29 11.72 1.03 11.02Q0.77 10.32 0.77 9.44L0.77 9.44Q0.77 8.61 0.99 7.92Q1.20 7.22 1.62 6.72Q2.04 6.22 2.65 5.94Q3.26 5.66 4.05 5.66L4.05 5.66Q4.76 5.66 5.29 5.86Q5.81 6.06 6.05 6.24L6.05 6.24L6.05 2.35L6.96 2.18ZM6.05 12.19L6.05 7.13Q5.92 7.03 5.73 6.92Q5.54 6.80 5.29 6.71Q5.04 6.61 4.75 6.54Q4.45 6.48 4.13 6.48L4.13 6.48Q3.46 6.48 3.00 6.72Q2.55 6.96 2.27 7.36Q1.99 7.76 1.86 8.29Q1.74 8.83 1.74 9.44L1.74 9.44Q1.74 10.86 2.45 11.63Q3.16 12.39 4.34 12.39L4.34 12.39Q5.01 12.39 5.42 12.33Q5.84 12.26 6.05 12.19L6.05 12.19ZM15.54 9.44L15.54 9.44Q15.54 10.29 15.30 10.99Q15.05 11.69 14.61 12.18Q14.17 12.67 13.57 12.94Q12.96 13.22 12.24 13.22L12.24 13.22Q11.51 13.22 10.91 12.94Q10.30 12.67 9.86 12.18Q9.42 11.69 9.18 10.99Q8.93 10.29 8.93 9.44L8.93 9.44Q8.93 8.58 9.18 7.88Q9.42 7.18 9.86 6.68Q10.30 6.19 10.91 5.92Q11.51 5.64 12.24 5.64L12.24 5.64Q12.96 5.64 13.57 5.92Q14.17 6.19 14.61 6.68Q15.05 7.18 15.30 7.88Q15.54 8.58 15.54 9.44ZM14.57 9.44L14.57 9.44Q14.57 8.08 13.94 7.27Q13.31 6.47 12.24 6.47L12.24 6.47Q11.16 6.47 10.53 7.27Q9.90 8.08 9.90 9.44L9.90 9.44Q9.90 10.79 10.53 11.59Q11.16 12.39 12.24 12.39L12.24 12.39Q13.31 12.39 13.94 11.59Q14.57 10.79 14.57 9.44ZM20.51 13.20L20.51 13.20Q19.67 13.20 19.03 12.94Q18.38 12.67 17.96 12.17Q17.53 11.68 17.30 10.98Q17.08 10.29 17.08 9.45L17.08 9.45Q17.08 8.60 17.31 7.90Q17.54 7.20 17.98 6.69Q18.41 6.19 19.03 5.92Q19.64 5.64 20.41 5.64L20.41 5.64Q21.00 5.64 21.51 5.74Q22.02 5.84 22.30 5.99L22.30 5.99L22.06 6.78Q21.78 6.64 21.43 6.55Q21.08 6.47 20.50 6.47L20.50 6.47Q19.29 6.47 18.67 7.25Q18.05 8.02 18.05 9.45L18.05 9.45Q18.05 10.09 18.19 10.63Q18.33 11.17 18.64 11.56Q18.96 11.94 19.45 12.16Q19.95 12.38 20.66 12.38L20.66 12.38Q21.25 12.38 21.65 12.24Q22.05 12.11 22.23 12.01L22.23 12.01L22.43 12.80Q22.18 12.94 21.64 13.07Q21.10 13.20 20.51 13.20ZM25.44 12.40L25.44 12.40Q26.22 12.40 26.73 12.14Q27.24 11.89 27.24 11.27L27.24 11.27Q27.24 10.98 27.15 10.77Q27.06 10.56 26.85 10.39Q26.64 10.22 26.30 10.07Q25.96 9.91 25.45 9.70L25.45 9.70Q25.05 9.53 24.68 9.36Q24.32 9.18 24.04 8.95Q23.76 8.72 23.59 8.40Q23.42 8.08 23.42 7.62L23.42 7.62Q23.42 6.73 24.09 6.19Q24.75 5.64 25.91 5.64L25.91 5.64Q26.66 5.64 27.14 5.77Q27.62 5.89 27.82 5.99L27.82 5.99L27.61 6.80Q27.44 6.72 27.04 6.58Q26.64 6.44 25.87 6.44L25.87 6.44Q25.56 6.44 25.29 6.50Q25.02 6.57 24.81 6.70Q24.60 6.83 24.47 7.04Q24.35 7.24 24.35 7.53L24.35 7.53Q24.35 7.83 24.46 8.04Q24.57 8.25 24.79 8.41Q25.00 8.57 25.32 8.71Q25.63 8.85 26.04 9.02L26.04 9.02Q26.46 9.18 26.85 9.36Q27.23 9.53 27.52 9.78Q27.82 10.02 28.00 10.37Q28.18 10.71 28.18 11.23L28.18 11.23Q28.18 12.21 27.45 12.71Q26.71 13.22 25.44 13.22L25.44 13.22Q24.49 13.22 23.98 13.05Q23.48 12.89 23.31 12.81L23.31 12.81L23.55 11.98Q23.59 12.01 23.73 12.07Q23.87 12.14 24.11 12.21Q24.35 12.29 24.68 12.35Q25.00 12.40 25.44 12.40ZM31.92 13.20L31.92 13.20Q31.46 12.35 31.03 11.42Q30.60 10.50 30.23 9.55Q29.86 8.61 29.55 7.67Q29.25 6.72 29.02 5.81L29.02 5.81L29.99 5.81Q30.14 6.48 30.38 7.26Q30.62 8.04 30.92 8.86Q31.22 9.69 31.58 10.56Q31.95 11.42 32.37 12.26L32.37 12.26Q32.68 11.40 32.91 10.63Q33.15 9.86 33.36 9.09Q33.56 8.33 33.75 7.53Q33.94 6.73 34.15 5.81L34.15 5.81L35.06 5.81Q34.61 7.84 34.03 9.76Q33.46 11.68 32.79 13.27L32.79 13.27Q32.52 13.90 32.24 14.36Q31.96 14.81 31.62 15.11Q31.28 15.40 30.82 15.54Q30.37 15.68 29.75 15.68L29.75 15.68Q29.40 15.68 29.11 15.60Q28.83 15.51 28.76 15.47L28.76 15.47L28.94 14.71Q28.99 14.76 29.25 14.83Q29.51 14.91 29.79 14.91L29.79 14.91Q30.18 14.91 30.50 14.83Q30.81 14.74 31.07 14.54Q31.32 14.34 31.52 14.01Q31.72 13.69 31.92 13.20ZM36.58 13.05L36.58 6.06Q36.99 5.95 37.67 5.81Q38.36 5.67 39.35 5.67L39.35 5.67Q40.18 5.67 40.73 5.91Q41.29 6.15 41.62 6.59Q41.94 7.03 42.08 7.64Q42.22 8.26 42.22 9.00L42.22 9.00L42.22 13.05L41.31 13.05L41.31 9.30Q41.31 8.53 41.21 7.99Q41.10 7.46 40.86 7.13Q40.61 6.79 40.22 6.64Q39.82 6.50 39.21 6.50L39.21 6.50Q38.57 6.50 38.10 6.57Q37.63 6.64 37.49 6.69L37.49 6.69L37.49 13.05L36.58 13.05ZM47.54 13.20L47.54 13.20Q46.70 13.20 46.06 12.94Q45.42 12.67 44.99 12.17Q44.56 11.68 44.34 10.98Q44.11 10.29 44.11 9.45L44.11 9.45Q44.11 8.60 44.35 7.90Q44.58 7.20 45.01 6.69Q45.44 6.19 46.06 5.92Q46.68 5.64 47.45 5.64L47.45 5.64Q48.03 5.64 48.55 5.74Q49.06 5.84 49.34 5.99L49.34 5.99L49.10 6.78Q48.82 6.64 48.47 6.55Q48.12 6.47 47.53 6.47L47.53 6.47Q46.33 6.47 45.70 7.25Q45.08 8.02 45.08 9.45L45.08 9.45Q45.08 10.09 45.22 10.63Q45.36 11.17 45.68 11.56Q45.99 11.94 46.49 12.16Q46.98 12.38 47.70 12.38L47.70 12.38Q48.29 12.38 48.69 12.24Q49.08 12.11 49.27 12.01L49.27 12.01L49.46 12.80Q49.21 12.94 48.67 13.07Q48.13 13.20 47.54 13.20Z"></path></g><!----><!----></svg>

menard-0.2.0/.github/branding/vector/default-monochrome.svg

@@ -0,0 +1 @@
+<svg data-v-423bf9ae="" xmlns="http://www.w3.org/2000/svg" viewBox="0 0 216.39999389648438 60" class="font"><!----><!----><!----><g data-v-423bf9ae="" id="fb39f943-3bd8-4482-9262-17621674b71f" fill="#DBDF24" transform="matrix(4.44444465637207,0,0,4.44444465637207,-3.422229528427124,-9.688892364501953)"><path d="M6.96 2.18L6.96 12.82Q6.55 12.96 5.92 13.09Q5.29 13.22 4.33 13.22L4.33 13.22Q3.53 13.22 2.88 12.96Q2.23 12.70 1.76 12.21Q1.29 11.72 1.03 11.02Q0.77 10.32 0.77 9.44L0.77 9.44Q0.77 8.61 0.99 7.92Q1.20 7.22 1.62 6.72Q2.04 6.22 2.65 5.94Q3.26 5.66 4.05 5.66L4.05 5.66Q4.76 5.66 5.29 5.86Q5.81 6.06 6.05 6.24L6.05 6.24L6.05 2.35L6.96 2.18ZM6.05 12.19L6.05 7.13Q5.92 7.03 5.73 6.92Q5.54 6.80 5.29 6.71Q5.04 6.61 4.75 6.54Q4.45 6.48 4.13 6.48L4.13 6.48Q3.46 6.48 3.00 6.72Q2.55 6.96 2.27 7.36Q1.99 7.76 1.86 8.29Q1.74 8.83 1.74 9.44L1.74 9.44Q1.74 10.86 2.45 11.63Q3.16 12.39 4.34 12.39L4.34 12.39Q5.01 12.39 5.42 12.33Q5.84 12.26 6.05 12.19L6.05 12.19ZM15.54 9.44L15.54 9.44Q15.54 10.29 15.30 10.99Q15.05 11.69 14.61 12.18Q14.17 12.67 13.57 12.94Q12.96 13.22 12.24 13.22L12.24 13.22Q11.51 13.22 10.91 12.94Q10.30 12.67 9.86 12.18Q9.42 11.69 9.18 10.99Q8.93 10.29 8.93 9.44L8.93 9.44Q8.93 8.58 9.18 7.88Q9.42 7.18 9.86 6.68Q10.30 6.19 10.91 5.92Q11.51 5.64 12.24 5.64L12.24 5.64Q12.96 5.64 13.57 5.92Q14.17 6.19 14.61 6.68Q15.05 7.18 15.30 7.88Q15.54 8.58 15.54 9.44ZM14.57 9.44L14.57 9.44Q14.57 8.08 13.94 7.27Q13.31 6.47 12.24 6.47L12.24 6.47Q11.16 6.47 10.53 7.27Q9.90 8.08 9.90 9.44L9.90 9.44Q9.90 10.79 10.53 11.59Q11.16 12.39 12.24 12.39L12.24 12.39Q13.31 12.39 13.94 11.59Q14.57 10.79 14.57 9.44ZM20.51 13.20L20.51 13.20Q19.67 13.20 19.03 12.94Q18.38 12.67 17.96 12.17Q17.53 11.68 17.30 10.98Q17.08 10.29 17.08 9.45L17.08 9.45Q17.08 8.60 17.31 7.90Q17.54 7.20 17.98 6.69Q18.41 6.19 19.03 5.92Q19.64 5.64 20.41 5.64L20.41 5.64Q21.00 5.64 21.51 5.74Q22.02 5.84 22.30 5.99L22.30 5.99L22.06 6.78Q21.78 6.64 21.43 6.55Q21.08 6.47 20.50 6.47L20.50 6.47Q19.29 6.47 18.67 7.25Q18.05 8.02 18.05 9.45L18.05 9.45Q18.05 10.09 18.19 10.63Q18.33 11.17 18.64 11.56Q18.96 11.94 19.45 12.16Q19.95 12.38 20.66 12.38L20.66 12.38Q21.25 12.38 21.65 12.24Q22.05 12.11 22.23 12.01L22.23 12.01L22.43 12.80Q22.18 12.94 21.64 13.07Q21.10 13.20 20.51 13.20ZM25.44 12.40L25.44 12.40Q26.22 12.40 26.73 12.14Q27.24 11.89 27.24 11.27L27.24 11.27Q27.24 10.98 27.15 10.77Q27.06 10.56 26.85 10.39Q26.64 10.22 26.30 10.07Q25.96 9.91 25.45 9.70L25.45 9.70Q25.05 9.53 24.68 9.36Q24.32 9.18 24.04 8.95Q23.76 8.72 23.59 8.40Q23.42 8.08 23.42 7.62L23.42 7.62Q23.42 6.73 24.09 6.19Q24.75 5.64 25.91 5.64L25.91 5.64Q26.66 5.64 27.14 5.77Q27.62 5.89 27.82 5.99L27.82 5.99L27.61 6.80Q27.44 6.72 27.04 6.58Q26.64 6.44 25.87 6.44L25.87 6.44Q25.56 6.44 25.29 6.50Q25.02 6.57 24.81 6.70Q24.60 6.83 24.47 7.04Q24.35 7.24 24.35 7.53L24.35 7.53Q24.35 7.83 24.46 8.04Q24.57 8.25 24.79 8.41Q25.00 8.57 25.32 8.71Q25.63 8.85 26.04 9.02L26.04 9.02Q26.46 9.18 26.85 9.36Q27.23 9.53 27.52 9.78Q27.82 10.02 28.00 10.37Q28.18 10.71 28.18 11.23L28.18 11.23Q28.18 12.21 27.45 12.71Q26.71 13.22 25.44 13.22L25.44 13.22Q24.49 13.22 23.98 13.05Q23.48 12.89 23.31 12.81L23.31 12.81L23.55 11.98Q23.59 12.01 23.73 12.07Q23.87 12.14 24.11 12.21Q24.35 12.29 24.68 12.35Q25.00 12.40 25.44 12.40ZM31.92 13.20L31.92 13.20Q31.46 12.35 31.03 11.42Q30.60 10.50 30.23 9.55Q29.86 8.61 29.55 7.67Q29.25 6.72 29.02 5.81L29.02 5.81L29.99 5.81Q30.14 6.48 30.38 7.26Q30.62 8.04 30.92 8.86Q31.22 9.69 31.58 10.56Q31.95 11.42 32.37 12.26L32.37 12.26Q32.68 11.40 32.91 10.63Q33.15 9.86 33.36 9.09Q33.56 8.33 33.75 7.53Q33.94 6.73 34.15 5.81L34.15 5.81L35.06 5.81Q34.61 7.84 34.03 9.76Q33.46 11.68 32.79 13.27L32.79 13.27Q32.52 13.90 32.24 14.36Q31.96 14.81 31.62 15.11Q31.28 15.40 30.82 15.54Q30.37 15.68 29.75 15.68L29.75 15.68Q29.40 15.68 29.11 15.60Q28.83 15.51 28.76 15.47L28.76 15.47L28.94 14.71Q28.99 14.76 29.25 14.83Q29.51 14.91 29.79 14.91L29.79 14.91Q30.18 14.91 30.50 14.83Q30.81 14.74 31.07 14.54Q31.32 14.34 31.52 14.01Q31.72 13.69 31.92 13.20ZM36.58 13.05L36.58 6.06Q36.99 5.95 37.67 5.81Q38.36 5.67 39.35 5.67L39.35 5.67Q40.18 5.67 40.73 5.91Q41.29 6.15 41.62 6.59Q41.94 7.03 42.08 7.64Q42.22 8.26 42.22 9.00L42.22 9.00L42.22 13.05L41.31 13.05L41.31 9.30Q41.31 8.53 41.21 7.99Q41.10 7.46 40.86 7.13Q40.61 6.79 40.22 6.64Q39.82 6.50 39.21 6.50L39.21 6.50Q38.57 6.50 38.10 6.57Q37.63 6.64 37.49 6.69L37.49 6.69L37.49 13.05L36.58 13.05ZM47.54 13.20L47.54 13.20Q46.70 13.20 46.06 12.94Q45.42 12.67 44.99 12.17Q44.56 11.68 44.34 10.98Q44.11 10.29 44.11 9.45L44.11 9.45Q44.11 8.60 44.35 7.90Q44.58 7.20 45.01 6.69Q45.44 6.19 46.06 5.92Q46.68 5.64 47.45 5.64L47.45 5.64Q48.03 5.64 48.55 5.74Q49.06 5.84 49.34 5.99L49.34 5.99L49.10 6.78Q48.82 6.64 48.47 6.55Q48.12 6.47 47.53 6.47L47.53 6.47Q46.33 6.47 45.70 7.25Q45.08 8.02 45.08 9.45L45.08 9.45Q45.08 10.09 45.22 10.63Q45.36 11.17 45.68 11.56Q45.99 11.94 46.49 12.16Q46.98 12.38 47.70 12.38L47.70 12.38Q48.29 12.38 48.69 12.24Q49.08 12.11 49.27 12.01L49.27 12.01L49.46 12.80Q49.21 12.94 48.67 13.07Q48.13 13.20 47.54 13.20Z"></path></g><!----><!----></svg>

menard-0.2.0/.github/dependabot.yml

@@ -0,0 +1,26 @@
+version: 2
+updates:
+  # Python dependencies
+  - package-ecosystem: "pip"
+    directory: "/"
+    schedule:
+      interval: "weekly"
+    open-pull-requests-limit: 10
+    groups:
+      python-dependencies:
+        patterns:
+          - "*"
+        update-types:
+          - "minor"
+          - "patch"
+
+  # GitHub Actions
+  - package-ecosystem: "github-actions"
+    directory: "/"
+    schedule:
+      interval: "weekly"
+    open-pull-requests-limit: 5
+    groups:
+      github-actions:
+        patterns:
+          - "*"

menard-0.2.0/.github/workflows/ci.yml

@@ -0,0 +1,48 @@
+name: CI
+
+on:
+  push:
+    branches: [main]
+  pull_request:
+    branches: [main]
+
+jobs:
+  test:
+    runs-on: ${{ matrix.os }}
+    strategy:
+      matrix:
+        os: [ubuntu-latest]
+        python-version: ["3.11", "3.12"]
+
+    steps:
+      - uses: actions/checkout@v6
+
+      - name: Install uv
+        uses: astral-sh/setup-uv@v7
+        with:
+          version: "latest"
+
+      - name: Set up Python ${{ matrix.python-version }}
+        run: uv python install ${{ matrix.python-version }}
+
+      - name: Install dependencies
+        run: uv sync
+
+      - name: Run ruff format check
+        run: uv run ruff format --check .
+
+      - name: Run ruff linter
+        run: uv run ruff check .
+
+      - name: Check for stale documentation
+        run: uv run menard check
+
+      - name: Run tests with coverage
+        run: uv run pytest --cov=src/menard --cov-report=term --cov-report=xml --cov-fail-under=60
+
+      - name: Upload coverage to Codecov
+        uses: codecov/codecov-action@v5
+        with:
+          file: ./coverage.xml
+          fail_ci_if_error: false
+          token: ${{ secrets.CODECOV_TOKEN }}

menard-0.2.0/.github/workflows/docs.yml

@@ -0,0 +1,49 @@
+name: Deploy Documentation
+
+on:
+  push:
+    branches:
+      - main
+
+permissions:
+  contents: read
+  pages: write
+  id-token: write
+
+concurrency:
+  group: "pages"
+  cancel-in-progress: false
+
+jobs:
+  build:
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+
+      - name: Install uv
+        uses: astral-sh/setup-uv@v5
+
+      - name: Set up Python
+        run: uv python install 3.11
+
+      - name: Install dependencies
+        run: uv sync
+
+      - name: Build documentation
+        run: uv run mkdocs build
+
+      - name: Upload artifact
+        uses: actions/upload-pages-artifact@v3
+        with:
+          path: site/
+
+  deploy:
+    environment:
+      name: github-pages
+      url: ${{ steps.deployment.outputs.page_url }}
+    runs-on: ubuntu-latest
+    needs: build
+    steps:
+      - name: Deploy to GitHub Pages
+        id: deployment
+        uses: actions/deploy-pages@v4

menard-0.2.0/.github/workflows/release.yml

@@ -0,0 +1,106 @@
+# Tag-based release workflow using commitizen
+#
+# This workflow:
+# 1. Detects if the merged commit is a version bump (from `cz bump` in PR)
+# 2. If yes: extracts version, creates git tag, builds, publishes to PyPI
+# 3. If no: exits successfully (normal PR merge)
+#
+# Developer workflow:
+# 1. Accumulate changes via normal PR merges
+# 2. When ready to release, create a PR running: uv run cz bump --changelog
+# 3. Merge bump PR → this workflow creates tag and publishes
+#
+# Recovery workflow (when release fails after bump merge):
+# 1. Delete orphan tag if exists: git push origin :refs/tags/vX.Y.Z
+# 2. Trigger manually: gh workflow run release.yml --ref main
+name: Release
+on:
+  push:
+    branches: [main]
+  workflow_dispatch:  # Manual trigger for recovery scenarios
+
+jobs:
+  release:
+    name: Release
+    runs-on: ubuntu-latest
+    # Run if: push with bump commit OR manual trigger (workflow_dispatch)
+    if: startsWith(github.event.head_commit.message, 'bump:') || github.event_name == 'workflow_dispatch'
+    permissions:
+      contents: write  # Required for creating tags and releases
+      id-token: write  # Required for trusted PyPI publishing
+    steps:
+      - uses: actions/checkout@v6
+        with:
+          fetch-depth: 0  # Full history for tag creation
+
+      - name: Install uv
+        uses: astral-sh/setup-uv@v7
+
+      - name: Set up Python
+        run: uv python install 3.11
+
+      - name: Install dependencies
+        run: uv sync
+
+      - name: Extract version from pyproject.toml
+        id: version
+        run: |
+          # Use head -1 because pyproject.toml has two version lines:
+          # 1. [project].version (the package version - what we want)
+          # 2. [tool.commitizen].version (kept in sync by cz bump)
+          VERSION=$(grep '^version = ' pyproject.toml | head -1 | sed 's/version = "\(.*\)"/\1/')
+          echo "version=$VERSION" >> $GITHUB_OUTPUT
+          echo "tag=v$VERSION" >> $GITHUB_OUTPUT
+          echo "Detected version: $VERSION (tag: v$VERSION)"
+
+      - name: Check release status
+        id: release_check
+        run: |
+          TAG="v${{ steps.version.outputs.version }}"
+
+          # Check if GitHub Release exists (the real indicator of a completed release)
+          if gh release view "$TAG" >/dev/null 2>&1; then
+            echo "Release $TAG already exists, nothing to do"
+            echo "release_exists=true" >> $GITHUB_OUTPUT
+            echo "tag_exists=true" >> $GITHUB_OUTPUT
+          else
+            echo "release_exists=false" >> $GITHUB_OUTPUT
+            # Check if tag exists (may need to skip tag creation but still publish)
+            if git rev-parse "$TAG" >/dev/null 2>&1; then
+              echo "Tag $TAG exists but no release - recovery mode"
+              echo "tag_exists=true" >> $GITHUB_OUTPUT
+            else
+              echo "Tag $TAG does not exist, full release"
+              echo "tag_exists=false" >> $GITHUB_OUTPUT
+            fi
+          fi
+        env:
+          GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}
+
+      - name: Create git tag
+        if: steps.release_check.outputs.tag_exists == 'false'
+        run: |
+          git config --local user.email "github-actions[bot]@users.noreply.github.com"
+          git config --local user.name "github-actions[bot]"
+          git tag -a "${{ steps.version.outputs.tag }}" -m "Release ${{ steps.version.outputs.tag }}"
+          git push origin "${{ steps.version.outputs.tag }}"
+
+      - name: Build package
+        if: steps.release_check.outputs.release_exists == 'false'
+        run: uv build
+
+      - name: Publish to PyPI
+        if: steps.release_check.outputs.release_exists == 'false'
+        uses: pypa/gh-action-pypi-publish@release/v1
+        with:
+          print-hash: true
+
+      - name: Create GitHub Release
+        if: steps.release_check.outputs.release_exists == 'false'
+        run: |
+          gh release create "${{ steps.version.outputs.tag }}" \
+            --title "${{ steps.version.outputs.tag }}" \
+            --notes "See [CHANGELOG](https://github.com/${{ github.repository }}/blob/main/CHANGELOG.md) for details." \
+            dist/*
+        env:
+          GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}

menard-0.2.0/.gitignore

@@ -0,0 +1,51 @@
+# 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
+
+# Virtual environments
+venv/
+ENV/
+env/
+
+# Testing
+.pytest_cache/
+.coverage
+htmlcov/
+
+# IDE
+.vscode/
+.idea/
+*.swp
+*.swo
+
+# Testbed (created by scripts, not part of package)
+testbed/
+
+# UV/ruff cache
+.ruff_cache/
+
+# docsync cache (but keep config files)
+.docsync/*
+!.docsync/links.toml
+!.docsync/donttouch
+.menard/cache/
+.menard/*.json
+.menard/*.state

menard-0.2.0/.menard/donttouch

@@ -0,0 +1,21 @@
+# License sections must not change without explicit decision
+README.md#License
+docs/contributing.md#License
+docs/index.md#License
+
+# Code of Conduct is policy
+docs/contributing.md#Code of Conduct
+
+# Brand colors must be consistent
+mkdocs.yml#palette
+docs/stylesheets/extra.css
+
+# Version requirement
+"Python 3.11+"
+
+# Apache license identifier
+"Apache-2.0"
+
+# Brand color values (exact hex codes)
+"#7730E1"
+"#DBDF24"

menard-0.2.0/.menard/links.toml

@@ -0,0 +1,51 @@
+# menard links - code-documentation relationships
+
+# CLI module → CLI reference (auto-generated by mkdocs-click) + index quick start
+[[link]]
+code = "src/menard/cli.py"
+docs = ["docs/cli/reference.md"]
+auto_generated = true
+
+[[link]]
+code = "src/menard/cli.py"
+docs = ["docs/index.md#Quick Start"]
+
+# Configuration → configuration docs
+[[link]]
+code = "src/menard/config.py"
+docs = ["docs/configuration.md#pyproject.toml"]
+
+# Section parsing → configuration (staleness detection section)
+[[link]]
+code = "src/menard/sections.py"
+docs = ["docs/configuration.md#Staleness Detection"]
+
+# Staleness logic → configuration
+[[link]]
+code = "src/menard/staleness.py"
+docs = ["docs/configuration.md#Staleness Detection"]
+
+# Symbol extraction (AST) → staleness detection
+[[link]]
+code = "src/menard/symbols.py"
+docs = ["docs/configuration.md#Staleness Detection"]
+
+# TOML links → configuration
+[[link]]
+code = "src/menard/toml_links.py"
+docs = ["docs/configuration.md#links.toml"]
+
+# Hook → getting started + index
+[[link]]
+code = "src/menard/hook.py"
+docs = ["docs/getting-started.md", "docs/index.md#1. Track Doc Sync"]
+
+# Donttouch → configuration + index
+[[link]]
+code = "src/menard/donttouch.py"
+docs = ["docs/configuration.md#donttouch", "docs/index.md#2. Flag Protected Content Changes"]
+
+# Coverage → configuration
+[[link]]
+code = "src/menard/coverage.py"
+docs = ["docs/configuration.md#Validation and Coverage"]