selfdoc 0.4.0__tar.gz → 0.4.2__tar.gz

{selfdoc-0.4.0/.rlsbl/bases → selfdoc-0.4.2}/.github/workflows/ci.yml

@@ -11,12 +11,13 @@ jobs:
     runs-on: ubuntu-latest
     strategy:
       matrix:
+        # engines.node: >= 18
         node-version: [20, 22, 24]
     steps:
       - uses: actions/checkout@v6
       - uses: actions/setup-node@v6
         with:
           node-version: ${{ matrix.node-version }}
-      - run: node -e "require('./package.json')"
+      - run: npm ci
       - run: npm test --if-present
       - run: npm audit --audit-level=moderate || true

{selfdoc-0.4.0 → selfdoc-0.4.2}/.gitignore

@@ -31,4 +31,10 @@ docs/_build/
 .wrangler/
 
 # rlsbl
+.rlsbl-notes-*.tmp
 .rlsbl/lock
+.credentials.json
+.*-cache.json
+.env
+.env.local
+*.local-only

{selfdoc-0.4.0 → selfdoc-0.4.2/.rlsbl/bases}/.github/workflows/ci.yml

@@ -11,12 +11,13 @@ jobs:
     runs-on: ubuntu-latest
     strategy:
       matrix:
+        # engines.node: >= 18
         node-version: [20, 22, 24]
     steps:
       - uses: actions/checkout@v6
       - uses: actions/setup-node@v6
         with:
           node-version: ${{ matrix.node-version }}
-      - run: node -e "require('./package.json')"
+      - run: npm ci
       - run: npm test --if-present
       - run: npm audit --audit-level=moderate || true

{selfdoc-0.4.0 → selfdoc-0.4.2}/.rlsbl/bases/.gitignore

@@ -7,6 +7,7 @@ coverage/
 dist/
 *.egg-info/
 .rlsbl-notes-*.tmp
+.rlsbl/lock
 .credentials.json
 .*-cache.json
 .env

selfdoc-0.4.2/.rlsbl/bases/.rlsbl/hooks/pre-checks.sh

@@ -0,0 +1,5 @@
+#!/usr/bin/env bash
+set -euo pipefail
+# This hook runs BEFORE built-in pre-release checks (tests, lint).
+# Use it for setup tasks: starting services, setting env vars, etc.
+# Built-in checks run after this hook. Custom validation goes in pre-release.sh.

selfdoc-0.4.2/.rlsbl/bases/.rlsbl/hooks/pre-release.sh

@@ -0,0 +1,8 @@
+#!/usr/bin/env bash
+set -euo pipefail
+# Project-specific pre-release checks.
+# Built-in checks (tests, lint) run automatically before this hook.
+# Add custom validation here, e.g.:
+#   - Check for uncommitted documentation
+#   - Verify external service connectivity
+#   - Run integration tests not covered by the test suite

selfdoc-0.4.2/.rlsbl/bases/.rlsbl/lint/go.toml

@@ -0,0 +1,17 @@
+[forbidden-imports]
+modules = [
+    "net/http",
+    "github.com/spf13/cobra",
+    "github.com/urfave/cli",
+]
+
+[stdout]
+enabled = true
+ignore = []
+
+[entry-point]
+enabled = true
+ignore = []
+
+[files]
+exclude = []

selfdoc-0.4.2/.rlsbl/bases/.rlsbl/lint/npm.toml

@@ -0,0 +1,19 @@
+[forbidden-imports]
+modules = [
+    "express",
+    "koa",
+    "hono",
+    "commander",
+    "yargs",
+]
+
+[stdout]
+enabled = true
+ignore = []
+
+[entry-point]
+enabled = true
+ignore = []
+
+[files]
+exclude = []

selfdoc-0.4.2/.rlsbl/bases/.rlsbl/lint/python.toml

@@ -0,0 +1,25 @@
+[forbidden-imports]
+modules = [
+    "argparse",
+    "click",
+    "typer",
+    "flask",
+    "fastapi",
+    "django",
+    "uvicorn",
+    "granian",
+    "starlette",
+    "tornado",
+    "bottle",
+]
+
+[stdout]
+enabled = true
+ignore = []
+
+[entry-point]
+enabled = true
+ignore = []
+
+[files]
+exclude = []

{selfdoc-0.4.0 → selfdoc-0.4.2}/.rlsbl/bases/CLAUDE.md

@@ -1,4 +1,4 @@
-# selfdoc
+# selfdocumenting
 
 ## Release workflow
 

selfdoc-0.4.2/.rlsbl/changes/.validated

@@ -0,0 +1 @@
+13feaaa6579b99403184ebbc22dae7a207a0075d

selfdoc-0.4.2/.rlsbl/changes/0.1.0.jsonl

@@ -0,0 +1,10 @@
+{"commits":["ae78b3ce28843daf5b21a09e48197bdf5a0f1137","50e62733eff586502d60784393a038c4c2e6ec91","095232b91ea56882280cfa42abfdd9e7845b2fec","20d08b4b21489ffc83f794c9592a98bd92d86b2d"],"user_facing":true,"description":"Python, Go, TypeScript/JS extractors","type":"feature"}
+{"commits":["9ea6bd5d7b26693270fc38b8d0d905a97fe1e5eb","500a53298b83845aa1d0fa6b741d26755c2f87a6"],"user_facing":true,"description":"Custom directive plugins","type":"feature"}
+{"commits":["05a4982f26d3ccecbae55a0b0c6c0da941f544a5"],"user_facing":true,"description":"`selfdoc check` coverage analysis","type":"feature"}
+{"commits":["58c55ffd14aa6d93d0cf8a98e3d401670c3ea44c"],"user_facing":true,"description":"HTML generation with responsive CSS","type":"feature"}
+{"commits":["a1e1a3365a856919f0eac5ac4fca06397fddb98c"],"user_facing":true,"description":"Deploy to Cloudflare Pages + GitHub Pages","type":"feature"}
+{"commits":["c6c4ddb2335b0e90e73c3b3ad092406c334fae09"],"user_facing":true,"description":"SSE live reload in `selfdoc serve`","type":"feature"}
+{"commits":["61b923bc745ccf0faafb1abc23bb83d1b92f2622"],"user_facing":true,"description":"Code-aware static site generator","type":"feature"}
+{"commits":["58eba6c9092e6eb616a2a9a1df84a2167839c2eb"],"user_facing":true,"description":"`:::directive` syntax for embedding code-extracted content","type":"feature"}
+{"commits":["d59d5ab9d9e18c6093e1286ab44930c237f4bdb8"],"user_facing":true,"description":"5 built-in directives (module, schema, test, cli, config)","type":"feature"}
+{"commits":["172f6ed58ec73c9c145490edb13db415d05292a0","e58044dc796c0c199f2aa82d68c2bfbe7478af3a","970066c9f8c175dc9b36913278aaf7b3ab33f237","24894007b48e2e5861046e18948bd42444138d1a","baad8c307fbacaaaa31c418131a9f132bfaa5cd5","cef97f0284ef63a17e2ea50ff59f39f88d7702ed","9b26a61ff20bdd1399bdd7ae0ad5c181387f12bf","3c704c6d56be3210370a47c6be1e9cac47ff74dd","e044bb929975f616b2dfa4e401d11eccbdc4c1c1","86b7b7fa1fe55cd8d4b492ef935c8c7bee41691a"],"user_facing":false}

selfdoc-0.4.2/.rlsbl/changes/0.1.0.md

@@ -0,0 +1,13 @@
+## 0.1.0
+
+### Features
+
+- Python, Go, TypeScript/JS extractors
+- Custom directive plugins
+- `selfdoc check` coverage analysis
+- HTML generation with responsive CSS
+- Deploy to Cloudflare Pages + GitHub Pages
+- SSE live reload in `selfdoc serve`
+- Code-aware static site generator
+- `:::directive` syntax for embedding code-extracted content
+- 5 built-in directives (module, schema, test, cli, config)

selfdoc-0.4.2/.rlsbl/changes/0.2.0.jsonl

@@ -0,0 +1,12 @@
+{"commits":["1c00b760d0cfae84190f75f6199176f1010230e6"],"user_facing":true,"description":"Theme system with per-project theming via `\"theme\"` in selfdoc.json and optional `docs/custom.css` overrides","type":"feature"}
+{"commits":["8a89603db915e69a2f26d3ec7958cb37dfa92a87"],"user_facing":true,"description":"Syntax highlighting via highlight.js (light + dark themes)","type":"feature"}
+{"commits":["e700d39fb9287d7a2143d66adae12fdfab9dfc62"],"user_facing":true,"description":"Google-style docstring formatting (Args, Returns, Raises rendered as structured lists)","type":"feature"}
+{"commits":["d9f92cbd4a073993fd29af43c2794d1f790cb3a0"],"user_facing":true,"description":"Heading hierarchy: directive expansions use h2/h3/h4 instead of injecting h1","type":"feature"}
+{"commits":["444f28b7d303533e143dcc18fc4480ffa2c9c3d7"],"user_facing":true,"description":"Module name mangling (`selfdoc.extractorsthon` bug)","type":"feature"}
+{"commits":["e645dadb18607b945dbd5a7d570144a3f27f531c"],"user_facing":true,"description":"Nested `_build/_build` recursion when rebuilding","type":"feature"}
+{"commits":["b1ecbbb8f94c4400565ec28f9f62595c203753f1","51d8335f45dd725bd07a08cc0c1ccf70b46a6f69"],"user_facing":true,"description":"Deploy supports `CF_ACCOUNT_ID` and `CF_PAGES_API_TOKEN` env var names (remapped to wrangler's expected names)","type":"feature"}
+{"commits":["ea56606d8051baf6d2c38f6c919dfb0acf1a6d07"],"user_facing":true,"description":"Minimal theme: clean typography, dark mode, high-contrast, and reduced-motion variants (all auto-detected from OS preferences)","type":"feature"}
+{"commits":["b518d0637cedefb1d9934a98133af1a7f7f21c27"],"user_facing":true,"description":"Top bar with project name and version badge","type":"feature"}
+{"commits":["319971e2603ec16de81aae050b03ebd0055cc952"],"user_facing":true,"description":"Heading anchor links for deep linking","type":"feature"}
+{"commits":["fc225c09e14f00e62ffc60f36cc2a00177ce5b3d"],"user_facing":true,"description":"CSS extracted to cacheable `style.css` instead of inlined per page","type":"feature"}
+{"commits":["97eb815243ea150fcf086992ebe58aec04dc3841"],"user_facing":false}

selfdoc-0.4.2/.rlsbl/changes/0.2.0.md

@@ -0,0 +1,15 @@
+## 0.2.0
+
+### Features
+
+- Theme system with per-project theming via `"theme"` in selfdoc.json and optional `docs/custom.css` overrides
+- Syntax highlighting via highlight.js (light + dark themes)
+- Google-style docstring formatting (Args, Returns, Raises rendered as structured lists)
+- Heading hierarchy: directive expansions use h2/h3/h4 instead of injecting h1
+- Module name mangling (`selfdoc.extractorsthon` bug)
+- Nested `_build/_build` recursion when rebuilding
+- Deploy supports `CF_ACCOUNT_ID` and `CF_PAGES_API_TOKEN` env var names (remapped to wrangler's expected names)
+- Minimal theme: clean typography, dark mode, high-contrast, and reduced-motion variants (all auto-detected from OS preferences)
+- Top bar with project name and version badge
+- Heading anchor links for deep linking
+- CSS extracted to cacheable `style.css` instead of inlined per page

selfdoc-0.4.2/.rlsbl/changes/0.3.0.jsonl

@@ -0,0 +1,54 @@
+{"commits":["caebcff8cdd31e6413fca319e67e07bfa0fe4f70","9a69a0369e8d0b6111fadd974a209ccbbcfe0861","caac7c240adbc43b22d1c4895254b4e63316a5d7","33e999a6765a67a292e3b1acea18b3f298837ac0","e3aaadb584cceab6104bb6f8ec1e9bfd1ab3425b"],"user_facing":true,"description":"`base_url` is now a required field in `selfdoc.json` (previously optional)","type":"feature"}
+{"commits":["77e138dec3acdcaae4a284929fc2ed1ff30a049d","f9372ce76b3fc42a8c6372f3a4e98853926bf052","bf797f995df4e2aa27158dba8cf84f93c15db214"],"user_facing":true,"description":"Frontmatter `description` is now required on every page (auto-extraction removed); missing description is a build error","type":"feature"}
+{"commits":["60771dabb5516e16369f21f67351419305359f4e","324c0dbf1e358d7418dcadfbba19cb5ced0227ad"],"user_facing":true,"description":"`selfdoc build` now fails on SEO lint warnings","type":"feature"}
+{"commits":["2619efcd7b0d42b602632824332de4482b8f50e0","015a5597d6c40d504b337a7aafc1bcced12ab23b","57c7e718edb571223a74335e0fbefc43ee7f5f0e"],"user_facing":true,"description":"Subdirectory-based nested nav groups with collapsible sidebar sections, localStorage persistence, and frontmatter overrides (`nav_group`, `nav_order`)","type":"feature"}
+{"commits":["21504c13524bbc55aa664b9b0934b5d395548555"],"user_facing":true,"description":"Configurable search trigger via `search` config field: `\"icon\"` (magnifying glass button), `\"bar\"` (text input with Cmd+K hint), or `\"hidden\"`","type":"feature"}
+{"commits":["0d131c72d0ae8be13d6f6cf2b2017677ce24e42b"],"user_facing":true,"description":"Functional feedback widget via `feedback` config field with webhook POST and Google Analytics event support","type":"feature"}
+{"commits":["1982b46e41a63764793004b6f3d5f9be760fa7b2"],"user_facing":true,"description":"Atom feed generation (`feed.xml`) with auto-discovery `<link>` tag in `<head>`","type":"feature"}
+{"commits":["ac6485a0de73d2364de6de531d21fcde4f783550","a75fa71bdb87f8fe93152bcc162faa32eed8cf5e"],"user_facing":true,"description":"Definition list syntax (`term\\n: definition`) with glossary styling and DefinedTerm JSON-LD","type":"feature"}
+{"commits":["f92114f2c491aff670e04968755773a59f92717d"],"user_facing":true,"description":"Inline stat markup (`==value==`) producing semantic `<data>` elements","type":"feature"}
+{"commits":["da27d5477b8bdf088a2da0a5cbd4f7bd71bbf73f","29e8770c87089733d9b64bd07a74a7904dd6d367"],"user_facing":true,"description":"Code tabs for switching between language variants with localStorage persistence","type":"feature"}
+{"commits":["e8ab4604aab3308b06964fae1ee03f3914b6162a"],"user_facing":true,"description":"Git branch auto-detection for edit links; configurable via `branch` config field","type":"feature"}
+{"commits":["766777a719d7d46d759c28d78792755b53a79966","5223e6ec334b66981d7364d8d30770efc5862737","a2318b12e146cd77fe0c8e91b7be9c99e106c5df","09dfe8df82db49476a6cf666a906be1c8d15de86"],"user_facing":true,"description":"Rich OG card PNG generation with text overlay via predraw (optional dependency)","type":"feature"}
+{"commits":["0516a601f823a2ff6219a415aafba106a7f4086b","2cfe248f12d110f1fe1f000593780769dc8649c4","e1b062c92254e5573937847069f36c1eb87ee59c"],"user_facing":true,"description":"SEO lint framework with 15 rules covering headings, descriptions, images, contrast, and structured data","type":"feature"}
+{"commits":["c6a6313eb0348153960bdbfffa8cd21de21bb062","64a06f57f2c82bd69560ea28949c271e742810b2","04a0e16495770dbd6221bf5805d90ebbeaf47b87","c9b85969bedd79e55075fe2f9e0edd627a7291c1"],"user_facing":true,"description":"JSON-LD structured data: TechArticle, BreadcrumbList, WebSite, SoftwareSourceCode, Organization/Person, ItemList, DefinedTermSet","type":"feature"}
+{"commits":["caf8643aa5b538e132a985f289c5ef8e65eb8f0a","3d750f10bea0f4d088bbeb751b274adebaa18ec5","1f6d0f4809e16f28100f56b70de7c1d5a0c8cf33","5ab397f045955ff3f377fbffc2b213a388f2bcc8","8c718513a5d516a6b77a877591de039afd536a88","588b8db20d84adf83c000e41a320f092f026be6c","36aa3499b5933afd2bd78bbdede061da1005851b"],"user_facing":true,"description":"Open Graph and Twitter Card meta tags with `og:locale`, `og:image:alt`, and auto-generated social card images","type":"feature"}
+{"commits":["a217568277910f1816cb56e2dda020a573ff41cd","c28586550df64e5831f4b641156883207fbcdba0"],"user_facing":true,"description":"`robots.txt` with explicit AI crawler permissions (GPTBot, ClaudeBot, PerplexityBot, etc.)","type":"feature"}
+{"commits":["fb8b63244317795809e5ec257b3ea991de3bab02","9ad0e7e890018f47d2545e782935e0216e5bbada"],"user_facing":true,"description":"Visible \"Last updated\" dates with `<time>` elements, `dateModified` in JSON-LD, and sitemap `lastmod`","type":"feature"}
+{"commits":["76fa1f4cdfef4faed880c35307eb11c99f04f101","0d43900841969cf5436b7128590a44d0c56f922e"],"user_facing":true,"description":"`selfdoc check --ignore SEO007,SEO008` to suppress specific lint rules","type":"feature"}
+{"commits":["9ed5c18a520e1ee41a4b50c61c4d83b3c44fa95c"],"user_facing":true,"description":"`selfdoc check --format json` for machine-readable output","type":"feature"}
+{"commits":["7e5d1306b099f26694462b64eb375699bdfc578f"],"user_facing":true,"description":"Color-coded `selfdoc check` output (green/yellow/red by severity)","type":"feature"}
+{"commits":["a2c46291f1904aab2abf6662689f70e8d647ee3d","2019bbdcc512bd34d67db6b0375d7621b73479f2"],"user_facing":true,"description":"New config fields: `lang` (BCP 47), `author`, `twitter`, `branch`, `search`, `feedback`","type":"feature"}
+{"commits":["92e78abefa077efe1c0f3a8df1a46d6dffdc9705","d93935b49cd82dfee5fe88bb97a06f04ab73c0dc"],"user_facing":true,"description":"Sticky table headers no longer hide behind the fixed topbar","type":"feature"}
+{"commits":["0baa65381a77d891d1a9c9a7ead919b13c28d272","1b80538e440986aebee17d079033d5f3e4ead022","6bea2d4fe77b3c0f3b45f2a167fe4d5f63a8a389"],"user_facing":true,"description":"Copy button now always visible on code blocks (was hidden until hover, invisible on touch)","type":"feature"}
+{"commits":["0fbd0d77fc9445cbbf251e5c1e7b0e2487ab5594","82cee7e8be2a8c1e419e061f9e1b7103555a001e","80b8e30b03c6e1e8fe2686db6092562c5e662a46","e80f1333047116cac0c208b64a6fd1ee13ff421d"],"user_facing":true,"description":"Fixed dark mode contrast for all accent colors","type":"feature"}
+{"commits":["4ddbd75c8e5221b4ef3ed07a9028f741f72c6865"],"user_facing":true,"description":"Fixed breadcrumb intermediate links pointing to non-existent directory index pages","type":"feature"}
+{"commits":["80e0ebb6e3f5c2058fba390b159c97505842149f"],"user_facing":true,"description":"Build-time Pygments syntax highlighting (replaced client-side highlight.js)","type":"feature"}
+{"commits":["9e17135fa0dc54f61c7c9740eafeeb9442476178","7fd9a993230a1c11c50ffb41b8237ecabf1e8596","882005cd80025505e795c463e30767e078dd5bab"],"user_facing":true,"description":"Build-time CSS, JS, and HTML minification with critical CSS inlining","type":"feature"}
+{"commits":["d4d1342206a9745cf8755e885dbc649590227063"],"user_facing":true,"description":"Gzip and Brotli pre-compression of build output","type":"feature"}
+{"commits":["3d96198629cb8019bac735670154c088d0cedbd5"],"user_facing":true,"description":"Search JS externalized to `search.js` with lazy index loading","type":"feature"}
+{"commits":["4d1542309cfe53e798b68b0ad99346c9490c4c39"],"user_facing":true,"description":"Conditional JS inclusion based on page content","type":"feature"}
+{"commits":["a4fe538074c11d52d84ad86ef810397a8d4c14ef"],"user_facing":true,"description":"ARIA labels on sidebar nav, TOC nav, and search dialog","type":"feature"}
+{"commits":["2d46423d8de66d283d344b40bd4da4b7120a8d98"],"user_facing":true,"description":"Dynamic theme toggle ARIA label indicating current state","type":"feature"}
+{"commits":["7a5137e7c695dcb392fdab891e308411858dafb0"],"user_facing":true,"description":"Roving tabindex on code tabs per WAI-ARIA pattern","type":"feature"}
+{"commits":["2df37d3e06f36b5ec666391c2334078e0fed9a93","b62dc9b8b8ce1cc294b6237aadca9e38e30d0422"],"user_facing":true,"description":"Heading anchors visible on touch devices","type":"feature"}
+{"commits":["617a169801e5b45300d526432d82642e83e8c5a9","b227ef59ec967fd5e70144274e91d33c6af04dfe"],"user_facing":true,"description":"Card-style prev/next navigation links","type":"feature"}
+{"commits":["f609639c8ef83eb9bc8b5cab8a1c3b0bfb9302ce","2ebdc0c0612db4b4c6f2c88ac530e7a4b8fd0431"],"user_facing":true,"description":"Print stylesheet: 2cm margins, forced light colors, hidden breadcrumbs, code wrapping","type":"feature"}
+{"commits":["4512d0a2061baff5f92996541448e350f45e5d76","9a8e210a54050f413a9afd51fb1021bda1f3b822"],"user_facing":true,"description":"Security headers and trailing slash redirects for Cloudflare Pages","type":"feature"}
+{"commits":["a9f8329287c7fb70d1dc13f0e6a2c6f4173f4bbe"],"user_facing":true,"description":"Edit link shown at both top and bottom of content area","type":"feature"}
+{"commits":["6538269846eefc2543f17965a4d279ec4542ff9d"],"user_facing":true,"description":"`llms.txt` and `llms-full.txt` for AI documentation ingestion","type":"feature"}
+{"commits":["b62adfd673006acc2c60e0ef04422876710af995"],"user_facing":true,"description":"`selfdoc check` reports undocumented public symbols when coverage is below 100%","type":"feature"}
+{"commits":["edbaf9bb51242ba86aa218f5bb4e517408a7892e"],"user_facing":true,"description":"`lint_ignore` config field for project-level lint rule suppression","type":"feature"}
+{"commits":["9af7d53ae9e818d629e8f8c328d499123a7efc76"],"user_facing":true,"description":"Edit link and \"Last updated\" date no longer run together (flex layout with gap)","type":"feature"}
+{"commits":["1b9028ef38e21c25e36a669a1beb009854b44d5b"],"user_facing":true,"description":"Search shows \"No results\" message instead of blank space","type":"feature"}
+{"commits":["08ac2f8c54d2af91182698a8c0ac45eba3e6587f"],"user_facing":true,"description":"Search dialog closes when clicking a result link","type":"feature"}
+{"commits":["87089a200454885cfca4f17361fbacef2b5e74ec"],"user_facing":true,"description":"Fixed code-block hover shadow invisible in dark mode","type":"feature"}
+{"commits":["afb4db163dc8ae785a0e27e04a2497352db9a8dc"],"user_facing":true,"description":"Table `<caption>` derived from preceding heading for screen readers","type":"feature"}
+{"commits":["d1997e04b6181943a5cdd0ec22f08a7ab2f0fd31"],"user_facing":true,"description":"44px minimum touch targets on all interactive elements","type":"feature"}
+{"commits":["8d208c6696898e55eb02e4f0fb3147818a999c99"],"user_facing":true,"description":"Admonition icons (distinct SVG per type: info, lightbulb, warning triangle, octagon, exclamation)","type":"feature"}
+{"commits":["caec48eedeb4077385e0c757ff99a5b2bfc504da"],"user_facing":true,"description":"Styled generic `<details>/<summary>` in content","type":"feature"}
+{"commits":["3945f31a930790611f3d7f93c50c85c0a3d3bef5"],"user_facing":true,"description":"Styled standalone `<dfn>` tags outside glossary context","type":"feature"}
+{"commits":["475d3454b4ecdfad67becf2b653976147d4422d0"],"user_facing":true,"description":"RSS feed link in site footer","type":"feature"}
+{"commits":["af3efc02c3daae9273b629c0b97b89620f231379"],"user_facing":true,"description":"Fragment highlight animation when navigating to `#section` URLs","type":"feature"}
+{"commits":["f33b0f2791a0e80d84b47341a1dd8dd5300157d8"],"user_facing":true,"description":"Topbar truncates long project names with ellipsis","type":"feature"}
+{"commits":["10c2a16fa6848be083e1a9410c06fb25a1188a41","06905cacd1d4f7df67905fce3cf0d094565cd9e7","ef1169ac8f1dec5314e3c2d80176e90f921a1b36","7468ecc017a1f66a3f2a95c5c101112e93fe6824","d33fdd2e34945da7dcdad85fa9b7938c01049c19","c4b4606643f3e9db0db168db749a001c4485db5b","e7f1e630652721b725fd33cb344a4004e2ac1105","c1981a529e81d12fe4905767b28c42a5c0d1d925","35b224b25483623e028fb72c6d63489d91dc152a","7663d9dcc2e42c606dd8aa69ac364957be4bc780","1a38662d3f1a5e3288422d0bc3406a289d4281fc","f0413d4b715b16117d1a8503b07cfa01c56de21e","fbc3c4ac2e7f50bc607ba28ea550e612100fe345","f9928794403d7e05bee6c71a9919a89d2227865d","a4d0624259be77af943cce05bbdf47c7385a8b14","749e74238fe599c0f7859bddc2ce741bd6f4214f","c302b633158e056871d68573aeec910304b376e5","c2addfb75bd3ae2fd58c415f273713736a2a4bbe","4b0ec52589f5de9071f0753d8ecdd626e8027cb9","34c881b7395e64a2ad64da03076866b9d2306a54","f91044ed09096b880993c8bb467ba66071e83189","1bd78a4878f1d3066873d863e0b028e1d08862ea","5c135224a0f314698d70d8fc5875b993fc22b98d","5fc91de87f1fcddd7afda505d6bc7bae54258cdb","3d3ebcac77c827b62f00fd5a7444dd0d14eae9d8","51433b4dd1f67344b350d09af5857596560820c2","ad051a4dc1b650071d292978c00479d961e382c6","e3c6ad01adeb025f5c4c818af56c721bc91dc24a","ae7adaf4de9a025f85e5193e245c524ee42ade7a","fbdfaa1135e70059378ef35b083ef795c089f2b5"],"user_facing":false}

selfdoc-0.4.2/.rlsbl/changes/0.3.0.md

@@ -0,0 +1,57 @@
+## 0.3.0
+
+### Features
+
+- `base_url` is now a required field in `selfdoc.json` (previously optional)
+- Frontmatter `description` is now required on every page (auto-extraction removed); missing description is a build error
+- `selfdoc build` now fails on SEO lint warnings
+- Subdirectory-based nested nav groups with collapsible sidebar sections, localStorage persistence, and frontmatter overrides (`nav_group`, `nav_order`)
+- Configurable search trigger via `search` config field: `"icon"` (magnifying glass button), `"bar"` (text input with Cmd+K hint), or `"hidden"`
+- Functional feedback widget via `feedback` config field with webhook POST and Google Analytics event support
+- Atom feed generation (`feed.xml`) with auto-discovery `<link>` tag in `<head>`
+- Definition list syntax (`term\n: definition`) with glossary styling and DefinedTerm JSON-LD
+- Inline stat markup (`==value==`) producing semantic `<data>` elements
+- Code tabs for switching between language variants with localStorage persistence
+- Git branch auto-detection for edit links; configurable via `branch` config field
+- Rich OG card PNG generation with text overlay via predraw (optional dependency)
+- SEO lint framework with 15 rules covering headings, descriptions, images, contrast, and structured data
+- JSON-LD structured data: TechArticle, BreadcrumbList, WebSite, SoftwareSourceCode, Organization/Person, ItemList, DefinedTermSet
+- Open Graph and Twitter Card meta tags with `og:locale`, `og:image:alt`, and auto-generated social card images
+- `robots.txt` with explicit AI crawler permissions (GPTBot, ClaudeBot, PerplexityBot, etc.)
+- Visible "Last updated" dates with `<time>` elements, `dateModified` in JSON-LD, and sitemap `lastmod`
+- `selfdoc check --ignore SEO007,SEO008` to suppress specific lint rules
+- `selfdoc check --format json` for machine-readable output
+- Color-coded `selfdoc check` output (green/yellow/red by severity)
+- New config fields: `lang` (BCP 47), `author`, `twitter`, `branch`, `search`, `feedback`
+- Sticky table headers no longer hide behind the fixed topbar
+- Copy button now always visible on code blocks (was hidden until hover, invisible on touch)
+- Fixed dark mode contrast for all accent colors
+- Fixed breadcrumb intermediate links pointing to non-existent directory index pages
+- Build-time Pygments syntax highlighting (replaced client-side highlight.js)
+- Build-time CSS, JS, and HTML minification with critical CSS inlining
+- Gzip and Brotli pre-compression of build output
+- Search JS externalized to `search.js` with lazy index loading
+- Conditional JS inclusion based on page content
+- ARIA labels on sidebar nav, TOC nav, and search dialog
+- Dynamic theme toggle ARIA label indicating current state
+- Roving tabindex on code tabs per WAI-ARIA pattern
+- Heading anchors visible on touch devices
+- Card-style prev/next navigation links
+- Print stylesheet: 2cm margins, forced light colors, hidden breadcrumbs, code wrapping
+- Security headers and trailing slash redirects for Cloudflare Pages
+- Edit link shown at both top and bottom of content area
+- `llms.txt` and `llms-full.txt` for AI documentation ingestion
+- `selfdoc check` reports undocumented public symbols when coverage is below 100%
+- `lint_ignore` config field for project-level lint rule suppression
+- Edit link and "Last updated" date no longer run together (flex layout with gap)
+- Search shows "No results" message instead of blank space
+- Search dialog closes when clicking a result link
+- Fixed code-block hover shadow invisible in dark mode
+- Table `<caption>` derived from preceding heading for screen readers
+- 44px minimum touch targets on all interactive elements
+- Admonition icons (distinct SVG per type: info, lightbulb, warning triangle, octagon, exclamation)
+- Styled generic `<details>/<summary>` in content
+- Styled standalone `<dfn>` tags outside glossary context
+- RSS feed link in site footer
+- Fragment highlight animation when navigating to `#section` URLs
+- Topbar truncates long project names with ellipsis

selfdoc-0.4.2/.rlsbl/changes/0.3.1.jsonl

@@ -0,0 +1,2 @@
+{"commits":["3b7d938e23a3e6262ac820eee9c9501d6d73f678"],"user_facing":true,"description":"npm package renamed from `selfdoc` to `selfdocumenting` (npm blocks `selfdoc` due to similarity with abandoned `self-doc` package). Install via `npm install -g selfdocumenting` or `npx selfdocumenting`. The CLI command remains `selfdoc`.","type":"feature"}
+{"commits":["a726c122b4c388fee93cfd3f66cf721cbe85fed8","94c934a444a3055f45c50357dec87689ebb47e37","f41d54ea64d6fbc462551dd3fc4c125bf020c325"],"user_facing":false}

selfdoc-0.4.2/.rlsbl/changes/0.3.1.md

@@ -0,0 +1,5 @@
+## 0.3.1
+
+### Features
+
+- npm package renamed from `selfdoc` to `selfdocumenting` (npm blocks `selfdoc` due to similarity with abandoned `self-doc` package). Install via `npm install -g selfdocumenting` or `npx selfdocumenting`. The CLI command remains `selfdoc`.

selfdoc-0.4.2/.rlsbl/changes/0.4.0.jsonl

@@ -0,0 +1,69 @@
+{"commits":["666324783b9d4f37133d53d37e854dd1efe41db5","c0206a28db280d5148816aad3e2e460a38a5b0ff","a6d353a8ee7477ae8d37a05d0f356428f2d4f309","22b404cd6fbb09d7e18e4e70f5ec65d9f40eef6f","cdfc40748b56a6ca9105bf793a126c9c95ad1a66","79bac0d976c73b5ed0be0af4a8f796b6903f618c","5fb7b923567ee737eb8b66dad996d3618777f288"],"user_facing":true,"description":"Directive syntax redesigned: new attribute-based format (`:-:`, `:<:`, `:>:`) with a formal directive catalog replacing the old `:::name arg` syntax. All existing directive blocks must be migrated. The `glossary` directive is now `list-glossary`.","type":"feature"}
+{"commits":["358a2b4c47cea2558af1e6591bf1f85532aedc1e"],"user_facing":true,"description":"Custom directive scripts must update from `resolve(arg, config)` to `resolve(attrs, config, body)`. Body content is now forwarded.","type":"feature"}
+{"commits":["be0983af15c5e7a144c2b176da19a50b63df9eaf","2dee526df35b35a2d1725b8019423e7951b641b0"],"user_facing":true,"description":"Extractors refactored to a `LanguageExtractor` protocol with a registry. Custom extractor integrations may need updating.","type":"feature"}
+{"commits":["6f4fa6b4d07c737d42a8110969af985969189bbb","402e81ea2290e82f4485a5dd8446802e7d8c551d","bef0b8a0b503e6847f3f194ecd953f9c911f953e"],"user_facing":true,"description":"URL scheme changed from flat (`guide.html`) to directory-index (`guide/index.html`, served as `guide/`). All canonical URLs, sitemap entries, and internal links updated. External links pointing to old `.html` URLs will 404.","type":"feature"}
+{"commits":["7007c922b9b6feef21cb0201e37a86d67afd9b99","ba13cfd9daa284d1625040563b39ac0a9524e072"],"user_facing":true,"description":"H1 headings are now auto-generated from the page title. The first `# heading` in Markdown is consumed as the title source (not rendered as-is). Multiple `#` headings in a single page now cause a build error.","type":"feature"}
+{"commits":["f9ba480f4c7224c946cc93e362cea557a48f1642"],"user_facing":true,"description":"`selfdoc build` no longer exits 1 for lint warnings. Exit 1 is reserved for errors only. The `--warn-only` flag is deprecated (warnings are non-fatal by default).","type":"feature"}
+{"commits":["ec3e5cb6bbc168f755d686dcad03be6d85fcbf6c","13e651bfbb8d5ab8eea0beb98608c1fe4719fe45","8724a4f3890302f6cb0bad9670cb67e33992da3e"],"user_facing":true,"description":"`selfdoc gen` command: auto-generates documentation pages from source code structure, with exclusion patterns, `generated: true` frontmatter, and stale file cleanup","type":"feature"}
+{"commits":["664d97fa47f4b8f170b9a35a2be3c06bf1730b76"],"user_facing":true,"description":"`selfdoc gen-data` command: runs sandboxed scripts (via bubblewrap) to generate CSV/JSON data files for documentation","type":"feature"}
+{"commits":["5fdcac42253562d9f284f9354bb47e97c49466c2","815728cca6eea6be1288e34fe0ded21ef3f2d578"],"user_facing":true,"description":"First-class strictcli support: auto-detects strictcli usage and generates CLI documentation pages","type":"feature"}
+{"commits":["d20035f4fdfd75c536ba3031af70051f0f465510","23686ed9eb76e913bcf74ad18b9985b592a5f673"],"user_facing":true,"description":"Description staleness detection: `selfdoc check` warns (STALE001) when a page description no longer matches page content, tracked via content hashing in `.selfdoc/hashes/`","type":"feature"}
+{"commits":["b37c30939a4d7c1518a4026b724c63f93daa0126"],"user_facing":true,"description":"Pluggable search engine: choose `\"builtin\"`, `\"fuse\"`, or `\"minisearch\"` via the `search_engine` config field","type":"feature"}
+{"commits":["960e63ba3b62a9cfe54bc3f8ab3d2c8372df7d8f"],"user_facing":true,"description":"Landing page template: hero section with tagline, CTA button, and feature cards, configured via `branding` config field","type":"feature"}
+{"commits":["9349003789793b55f3ceb576eb1a2a843304a58d"],"user_facing":true,"description":"Cross-page term linking: `<dfn>` definitions automatically linked across pages with dotted-underline `.term-link` styling","type":"feature"}
+{"commits":["064fc82878725cf6446843e340d7644602ef215e"],"user_facing":true,"description":"Documentation coverage for Go (exported symbols) and TypeScript/JavaScript (`export` declarations), previously Python-only","type":"feature"}
+{"commits":["aa8663104feb6090e6973fa8b5da13413e38ffdb"],"user_facing":true,"description":"Per-symbol coverage tracking with configurable `min_coverage` threshold","type":"feature"}
+{"commits":["ae5299254add2fc666ea365a66bbdb956978f1a2"],"user_facing":true,"description":"Callout directives (note, tip, warning, danger, important) as first-class directive types","type":"feature"}
+{"commits":["ba6e98afe96447dbe0d76264a5dc0bcc7fac9a93","bd79c10f4554b89c30b488f531222ae84d322690"],"user_facing":true,"description":"Feed filtering via `feed: false` frontmatter; changelog pages auto-detected and excluded by default","type":"feature"}
+{"commits":["7a494163eac2ec4304d593c1609c8c9b2bc5fadb"],"user_facing":true,"description":"Reading progress bar fixed below the topbar","type":"feature"}
+{"commits":["1af3955c31507e329c4cd97b7decd9d6c32f192e"],"user_facing":true,"description":"Scroll affordance gradients on overflowing code blocks and tables","type":"feature"}
+{"commits":["f667d2ba444d20b625849624002bc6e443e17da8"],"user_facing":true,"description":"Sticky first column on horizontally-scrolling tables","type":"feature"}
+{"commits":["0972dae5598380ad0ac8aa9fb4d152350f89cad7","b12903c2cc737e4ed10172f05138609b76cfbaa6"],"user_facing":true,"description":"`auto_detect` config field to disable step guide and API entry heuristics globally or per-page via `auto_steps`/`auto_api` frontmatter","type":"feature"}
+{"commits":["a2fbf28591b53c1092daf0cc420b7a64943b1ac2","dd0861f3d34fa4f62ea4ffe1db9f9e87a0381813","de8921e2044d236b5b88f6e4b0daf9d8478f26c1","2f145d13e0737a251fb0c83a6441f9c5cfdfe2a4"],"user_facing":true,"description":"Markdown block tokenizer (`selfdoc/tokenizer.py`): standalone module with zero dependencies, 10 token types. Used internally for both HTML rendering and lint analysis.","type":"feature"}
+{"commits":["579ba29b91e660215e76b7702c3f74daa9b26055","7bd32566f361842af0ff7ac1350a9d23f4bd00ae","6459b88334e4d08ee94b5a532a94cf5a7b64786f","624f5eee9ced0263334c45b3980363639797ee1d"],"user_facing":true,"description":"Auto-commit system: `selfdoc build`, `check`, `init`, `gen`, and `gen-data` now auto-commit changed project files (hashes, generated docs, generated data). Disable with `--no-commit`. Uses `safegit` when available, falls back to git.","type":"feature"}
+{"commits":["e4217981327242aeeb97ee83b57408ceaccb4f4f","1abec30800407e19b71b2e553244244b6e089f8a"],"user_facing":true,"description":"Directive token support in tokenizer: `:::name arg` / `:::` blocks are recognized as structured tokens","type":"feature"}
+{"commits":["8c4393ba73e0b3ac126e9ae22171b1f327d8d531"],"user_facing":true,"description":"SearchAction in WebSite JSON-LD on the homepage, enabling Google sitelinks search","type":"feature"}
+{"commits":["95150c68f39cfb65db74b50cc58de07297a3a329","40ab8e292df5e4237912264be0577fe034922fe4","989d84b00a4b2db92eabf26ba3328b48bafb0a8b"],"user_facing":true,"description":"GitHub Pages security headers: `<meta http-equiv>` tags for X-Content-Type-Options, X-Frame-Options, and Content-Security-Policy injected when deploy target is `github-pages`","type":"feature"}
+{"commits":["6fef50269f2bb4c2c45e0b1573ee7e393f795f1b"],"user_facing":true,"description":"WCAG contrast validation for user `custom.css`: SEO012 checks CSS variable overrides in `docs/custom.css` against theme backgrounds","type":"feature"}
+{"commits":["fed7b48869a3981acc5851cc9685fb4155fb0c3e","7dd4aa11eb4bcef3d8c5cc72843e52676c410e1c"],"user_facing":true,"description":"High-contrast mode overrides: both themes override `--link`, `--text-secondary`, `--sidebar-text`, and `--sidebar-active` in `prefers-contrast: more` media query","type":"feature"}
+{"commits":["c7a2d30ca00613223089875aef20ab5f2002461a"],"user_facing":true,"description":"Heading anchor IDs now deduplicate (appends `-1`, `-2` for repeated headings) and preserve Unicode characters","type":"feature"}
+{"commits":["0505103790d7d809778e0668480d437375635a03"],"user_facing":true,"description":"Scrollspy correctly tracks headings when scrolling in both directions","type":"feature"}
+{"commits":["2a5a7c54aba730089854f3f6292c3b1c30f01115"],"user_facing":true,"description":"Step guide detection tightened: keyword must appear at start of heading text, 200-char lookback (no more false positives on \"Next Steps\" or \"Troubleshooting Steps\")","type":"feature"}
+{"commits":["9125fa32331204925501bc0c3e9812b8844e3941"],"user_facing":true,"description":"API entry wrapping tightened: requires identifier-like heading and single-line code block (no more false positives on tutorial sections)","type":"feature"}
+{"commits":["f913a36f50d8f50af4e69761c50d1130290a8e58"],"user_facing":true,"description":"Prev/next links show directional labels (\"Previous\" / \"Next\") above page titles","type":"feature"}
+{"commits":["8646841b641d5246114eeb7d84f872a2ae989040","57b8ba4033aa3bad9fb3010a467e80cf8ccb8d8c"],"user_facing":true,"description":"Admonition icons use CSS mask-image technique, adapting correctly to dark mode","type":"feature"}
+{"commits":["1311c0180438b5ca78f1f3f50b9a9dd3be3ad0aa"],"user_facing":true,"description":"Diff highlighting uses `+`/`-` prefix symbols in addition to color","type":"feature"}
+{"commits":["da581e4ef8a7fc43bc0513cfa48226a9b3df9519"],"user_facing":true,"description":"Collapsible section indicators replaced with 16x16px SVG chevrons (previously 8x12px CSS triangles)","type":"feature"}
+{"commits":["0f617b38e2a5fd2076e822054b23f3c4950b6f36","05189c4a863a229d7bd75d82affda053cf3564d3","a49b7523cc70094301e718140ecc9c06832dd2f3","162c200f47b9e37afcbfa5ef64412f7d803073a4","e207ed6dfcc07e6b03fd823e33f984c8c5f255a2"],"user_facing":true,"description":"Clean theme link color (`#635bff`) barely passed WCAG AA in light mode (4.70:1) and failed in dark mode (4.23:1). New color `#5046e4` passes comfortably (6.29:1 light, 5.93:1 dark).","type":"feature"}
+{"commits":["cd9cd73eb5ada98570e8c1d3e51772d59a27dadf","340f023b95e7d1d98cbb4aede8762df8d73b5e78","4304ec0451f294cb08d6c4f4ec719d3532fc92ff"],"user_facing":true,"description":"SEO lint false positives from fenced code blocks: heading counts (SEO001), heading level gaps (SEO002), empty alt text (SEO003), paragraph length (SEO007), empty sections (SEO011), and all other checks now use the tokenizer, making them immune to code block content","type":"feature"}
+{"commits":["1dfeed4368b028f02c73181893aab65eaea64362"],"user_facing":true,"description":"SEO007 false positives on directive-heavy pages: when a heading is followed by a `:::directive` block, the short-paragraph warning is suppressed","type":"feature"}
+{"commits":["9d7c0bcf5d66aa120aa2c91b1faa0bd6a6da57fb"],"user_facing":true,"description":"Statistics density check (SEO008) now evaluates prose content only, excluding code blocks","type":"feature"}
+{"commits":["f54068bb534c8eb8e86db1ee65d7c1174b088390"],"user_facing":true,"description":"`md_to_html()` refactored from a 180-line line-walking loop into a clean tokenize-then-render pipeline","type":"feature"}
+{"commits":["adfc067412347546f1c2ee3ff5f52b2feeb2a0ce"],"user_facing":true,"description":"`_redirects` file is no longer generated (directory-index URLs don't need trailing-slash redirects)","type":"feature"}
+{"commits":["00a66be6a3b5e5027789446c882fefa2820f72cd"],"user_facing":true,"description":"`_headers` file is now only generated for `cloudflare-pages` deploy target","type":"feature"}
+{"commits":["ae7a3a641d1b883060ba423d37c1d60a6e714331"],"user_facing":true,"description":"Auto-generated glossary page: collects all `<dfn>` terms site-wide into an alphabetical glossary with source links","type":"feature"}
+{"commits":["74897510d7e34dabe2b74943658fa47aa3669579"],"user_facing":true,"description":"Changelog auto-detection: `CHANGELOG.md` in project root is automatically included as a documentation page","type":"feature"}
+{"commits":["43a93d8302b1c6eac2754465b36312f97606ed9c"],"user_facing":true,"description":"`selfdoc build --warn-only` flag to treat lint warnings as non-fatal","type":"feature"}
+{"commits":["954aefd563a1cf7c369c9a460dd72f3581853ff9"],"user_facing":true,"description":"Page progress indicator (\"Page X of Y\") between prev/next links","type":"feature"}
+{"commits":["7523c7278c3c53b55052f04af093267ac4ae4b42"],"user_facing":true,"description":"Current page title shown in the topbar on non-index pages","type":"feature"}
+{"commits":["257dee101ab0bb1073e7f7526cc5e069431af230"],"user_facing":true,"description":"URL-triggered search: navigate to `?q=term` to open search pre-filled with results","type":"feature"}
+{"commits":["c20bdad56e773e005b84d39da5edb8ecdb9559b7"],"user_facing":true,"description":"Meta description auto-generation: pages without frontmatter `description` now get `<meta name=\"description\">` auto-extracted from the first paragraph","type":"feature"}
+{"commits":["830289314238a526bbcff7bcfd4777b6ccb1ec3c"],"user_facing":true,"description":"Horizontal rule support: `---`, `***`, and `___` in Markdown now render as `<hr>`","type":"feature"}
+{"commits":["08651f75f5bb4da433e60461ccfbc62cf9db8b58"],"user_facing":true,"description":"Code tab sync no longer infinite-loops with 3+ tab groups sharing a language","type":"feature"}
+{"commits":["b7c63b3422c49a1899e2358bba7cb6ebb311fd43"],"user_facing":true,"description":"Heading copy-to-clipboard shows a toast notification","type":"feature"}
+{"commits":["2c26729d2c9970f5ee63b73a776968b8552ae7b8"],"user_facing":true,"description":"Edit link opens in a new tab","type":"feature"}
+{"commits":["33fda85e5f3d19194311f758ed74e3ea9ba2069d"],"user_facing":true,"description":"OG description falls back to first paragraph when no frontmatter description","type":"feature"}
+{"commits":["4f0a7c47ed9de47fe266a69c92074d51b60de235"],"user_facing":true,"description":"Each admonition type has a distinct background color","type":"feature"}
+{"commits":["f38467314db0bfdb534ac73092c5a504eb007af3"],"user_facing":true,"description":"Focus indicators use `:focus-visible` throughout (keyboard-only, no mouse outlines)","type":"feature"}
+{"commits":["e81129f0f90dbb2ec404471844b00c926d6b7a95"],"user_facing":true,"description":"Sidebar active link has a visible background highlight","type":"feature"}
+{"commits":["521dad0ee7f35ee4c9e0cd2c282efcab6a1e9d52"],"user_facing":true,"description":"Mobile sidebar traps focus within the overlay","type":"feature"}
+{"commits":["341ccae830d7741fabdb856597432b3170108ff5"],"user_facing":true,"description":"Mobile sidebar closes on Escape key","type":"feature"}
+{"commits":["06813377422a686703285b55d6435848f4dd6146"],"user_facing":true,"description":"Table rows highlight on hover","type":"feature"}
+{"commits":["0080857f63910e47ea76d6f49dda5b6c287f7448"],"user_facing":true,"description":"Cmd+K label adapts to platform (shows Ctrl+K on Windows/Linux)","type":"feature"}
+{"commits":["e015ddba6e22ffbc8241f791c3184f6d608e78dd"],"user_facing":true,"description":"\"Last updated\" date shown at the top of the page alongside breadcrumbs","type":"feature"}
+{"commits":["c59aa6533583e73b0008962af9c265ae0586367c"],"user_facing":true,"description":"Search \"no results\" message includes guidance (\"Try different terms or browse the sidebar\")","type":"feature"}
+{"commits":["ead839908ec109d16558023d7904a547f3d88794"],"user_facing":true,"description":"Feedback \"No\" response prompts for written feedback instead of just \"Thanks\"","type":"feature"}
+{"commits":["418261317ca288a97651e85b84cc53a05a4d6fc8"],"user_facing":true,"description":"Negative feedback provides a text input for follow-up","type":"feature"}
+{"commits":["a752a3bb5a5b3a0bdb0a2a1dd26f09c5d90d1174"],"user_facing":true,"description":"`<summary>` elements have `:focus-visible` outlines","type":"feature"}
+{"commits":["bfac98bab192d21d24f6147ae44cd386dcc31220"],"user_facing":true,"description":"`<pre>` elements have `aria-label` describing the code language","type":"feature"}
+{"commits":["8397ecd5172182f572443e6c9818b8b795c24d37"],"user_facing":true,"description":"`llms-full.txt` includes page boundaries with title headings and path comments","type":"feature"}

selfdoc-0.4.2/.rlsbl/changes/0.4.0.md

@@ -0,0 +1,73 @@
+## 0.4.0
+
+### Features
+
+- Directive syntax redesigned: new attribute-based format (`:-:`, `:<:`, `:>:`) with a formal directive catalog replacing the old `:::name arg` syntax. All existing directive blocks must be migrated. The `glossary` directive is now `list-glossary`.
+- Custom directive scripts must update from `resolve(arg, config)` to `resolve(attrs, config, body)`. Body content is now forwarded.
+- Extractors refactored to a `LanguageExtractor` protocol with a registry. Custom extractor integrations may need updating.
+- URL scheme changed from flat (`guide.html`) to directory-index (`guide/index.html`, served as `guide/`). All canonical URLs, sitemap entries, and internal links updated. External links pointing to old `.html` URLs will 404.
+- H1 headings are now auto-generated from the page title. The first `# heading` in Markdown is consumed as the title source (not rendered as-is). Multiple `#` headings in a single page now cause a build error.
+- `selfdoc build` no longer exits 1 for lint warnings. Exit 1 is reserved for errors only. The `--warn-only` flag is deprecated (warnings are non-fatal by default).
+- `selfdoc gen` command: auto-generates documentation pages from source code structure, with exclusion patterns, `generated: true` frontmatter, and stale file cleanup
+- `selfdoc gen-data` command: runs sandboxed scripts (via bubblewrap) to generate CSV/JSON data files for documentation
+- First-class strictcli support: auto-detects strictcli usage and generates CLI documentation pages
+- Description staleness detection: `selfdoc check` warns (STALE001) when a page description no longer matches page content, tracked via content hashing in `.selfdoc/hashes/`
+- Pluggable search engine: choose `"builtin"`, `"fuse"`, or `"minisearch"` via the `search_engine` config field
+- Landing page template: hero section with tagline, CTA button, and feature cards, configured via `branding` config field
+- Cross-page term linking: `<dfn>` definitions automatically linked across pages with dotted-underline `.term-link` styling
+- Documentation coverage for Go (exported symbols) and TypeScript/JavaScript (`export` declarations), previously Python-only
+- Per-symbol coverage tracking with configurable `min_coverage` threshold
+- Callout directives (note, tip, warning, danger, important) as first-class directive types
+- Feed filtering via `feed: false` frontmatter; changelog pages auto-detected and excluded by default
+- Reading progress bar fixed below the topbar
+- Scroll affordance gradients on overflowing code blocks and tables
+- Sticky first column on horizontally-scrolling tables
+- `auto_detect` config field to disable step guide and API entry heuristics globally or per-page via `auto_steps`/`auto_api` frontmatter
+- Markdown block tokenizer (`selfdoc/tokenizer.py`): standalone module with zero dependencies, 10 token types. Used internally for both HTML rendering and lint analysis.
+- Auto-commit system: `selfdoc build`, `check`, `init`, `gen`, and `gen-data` now auto-commit changed project files (hashes, generated docs, generated data). Disable with `--no-commit`. Uses `safegit` when available, falls back to git.
+- Directive token support in tokenizer: `:::name arg` / `:::` blocks are recognized as structured tokens
+- SearchAction in WebSite JSON-LD on the homepage, enabling Google sitelinks search
+- GitHub Pages security headers: `<meta http-equiv>` tags for X-Content-Type-Options, X-Frame-Options, and Content-Security-Policy injected when deploy target is `github-pages`
+- WCAG contrast validation for user `custom.css`: SEO012 checks CSS variable overrides in `docs/custom.css` against theme backgrounds
+- High-contrast mode overrides: both themes override `--link`, `--text-secondary`, `--sidebar-text`, and `--sidebar-active` in `prefers-contrast: more` media query
+- Heading anchor IDs now deduplicate (appends `-1`, `-2` for repeated headings) and preserve Unicode characters
+- Scrollspy correctly tracks headings when scrolling in both directions
+- Step guide detection tightened: keyword must appear at start of heading text, 200-char lookback (no more false positives on "Next Steps" or "Troubleshooting Steps")
+- API entry wrapping tightened: requires identifier-like heading and single-line code block (no more false positives on tutorial sections)
+- Prev/next links show directional labels ("Previous" / "Next") above page titles
+- Admonition icons use CSS mask-image technique, adapting correctly to dark mode
+- Diff highlighting uses `+`/`-` prefix symbols in addition to color
+- Collapsible section indicators replaced with 16x16px SVG chevrons (previously 8x12px CSS triangles)
+- Clean theme link color (`#635bff`) barely passed WCAG AA in light mode (4.70:1) and failed in dark mode (4.23:1). New color `#5046e4` passes comfortably (6.29:1 light, 5.93:1 dark).
+- SEO lint false positives from fenced code blocks: heading counts (SEO001), heading level gaps (SEO002), empty alt text (SEO003), paragraph length (SEO007), empty sections (SEO011), and all other checks now use the tokenizer, making them immune to code block content
+- SEO007 false positives on directive-heavy pages: when a heading is followed by a `:::directive` block, the short-paragraph warning is suppressed
+- Statistics density check (SEO008) now evaluates prose content only, excluding code blocks
+- `md_to_html()` refactored from a 180-line line-walking loop into a clean tokenize-then-render pipeline
+- `_redirects` file is no longer generated (directory-index URLs don't need trailing-slash redirects)
+- `_headers` file is now only generated for `cloudflare-pages` deploy target
+- Auto-generated glossary page: collects all `<dfn>` terms site-wide into an alphabetical glossary with source links
+- Changelog auto-detection: `CHANGELOG.md` in project root is automatically included as a documentation page
+- `selfdoc build --warn-only` flag to treat lint warnings as non-fatal
+- Page progress indicator ("Page X of Y") between prev/next links
+- Current page title shown in the topbar on non-index pages
+- URL-triggered search: navigate to `?q=term` to open search pre-filled with results
+- Meta description auto-generation: pages without frontmatter `description` now get `<meta name="description">` auto-extracted from the first paragraph
+- Horizontal rule support: `---`, `***`, and `___` in Markdown now render as `<hr>`
+- Code tab sync no longer infinite-loops with 3+ tab groups sharing a language
+- Heading copy-to-clipboard shows a toast notification
+- Edit link opens in a new tab
+- OG description falls back to first paragraph when no frontmatter description
+- Each admonition type has a distinct background color
+- Focus indicators use `:focus-visible` throughout (keyboard-only, no mouse outlines)
+- Sidebar active link has a visible background highlight
+- Mobile sidebar traps focus within the overlay
+- Mobile sidebar closes on Escape key
+- Table rows highlight on hover
+- Cmd+K label adapts to platform (shows Ctrl+K on Windows/Linux)
+- "Last updated" date shown at the top of the page alongside breadcrumbs
+- Search "no results" message includes guidance ("Try different terms or browse the sidebar")
+- Feedback "No" response prompts for written feedback instead of just "Thanks"
+- Negative feedback provides a text input for follow-up
+- `<summary>` elements have `:focus-visible` outlines
+- `<pre>` elements have `aria-label` describing the code language
+- `llms-full.txt` includes page boundaries with title headings and path comments

selfdoc-0.4.2/.rlsbl/changes/0.4.1.jsonl

@@ -0,0 +1,2 @@
+{"commits":["53492ef093d43e3f4021da410541886a83ba4afc","666f3257150a37ff984868a91d2625c1cdf1a1dc"],"user_facing":false}
+{"commits":["9e32c30dbac4da66004cdbeb0811a8c868b43595"],"user_facing":false}

selfdoc-0.4.2/.rlsbl/changes/0.4.1.md

@@ -0,0 +1,3 @@
+## 0.4.1
+
+- No user-facing changes.

selfdoc-0.4.2/.rlsbl/changes/0.4.2.jsonl

@@ -0,0 +1,7 @@
+{"commits":["c49c0921c49011c8644a6bc7ddd6b71a0f660060"],"user_facing":false}
+{"commits":["c5501cdc68770602dee65bf78614a6cb0262ab55"],"user_facing":false}
+{"commits":["a32257fd22f1531003ec60ee9c4f00cf0a521c9b"],"user_facing":false}
+{"commits":["1928ad226a3657c089941e017025ea49b846574e","bd31871260c794b8069521c1b8282c8648d2ecc1","f62fd7ba0ae9bb6d74e34222e00be481f6f86caf"],"user_facing":false}
+{"commits":["23795ad5b0a0460a9fd800cbaa01b352654bb5d7"],"user_facing":false}
+{"commits":["583c7fcfae40623860c9b3cdcfa32226fe30be3d"],"user_facing":true,"description":"Auto-commit prefers rlsbl commit when available, marking commits with Autogenerated trailer for changelog coverage exemption","type":"feature"}
+{"commits":["6de2021cc4e20bb17450a37412740a76332e701a"],"user_facing":false}

selfdoc-0.4.2/.rlsbl/changes/0.4.2.md

@@ -0,0 +1,5 @@
+## 0.4.2
+
+### Features
+
+- Auto-commit prefers rlsbl commit when available, marking commits with Autogenerated trailer for changelog coverage exemption

selfdoc-0.4.2/.rlsbl/config.json

@@ -0,0 +1,7 @@
+{
+  "targets": [
+    "npm",
+    "pypi",
+    "docs"
+  ]
+}

selfdoc-0.4.2/.rlsbl/hashes.json

@@ -0,0 +1,14 @@
+{
+  ".github/workflows/ci.yml": "cd338ccb3d56298b8b6211ca46de34cde8eda0defdd9c4dde8b6f9ad5e8af51d",
+  ".github/workflows/publish.yml": "ff275580a98127104d28ce4a9b2992ce6a30a5d96de9bfcaa1b95bee97e5e2da",
+  "CLAUDE.md": "d616e99c7bd5f1d8f03735c14f4cafa7cabac6886e8792f8a3200b04130d45af",
+  ".rlsbl/hooks/pre-release.sh": "bb20a1ea350e5ed30ede93498e4aff1d1397eaeb37397d4a7168a7c9006ac1a7",
+  ".rlsbl/hooks/post-release.sh": "b455f8511e0b2655509ecf5dcb0ab7da5bb7c961f47910ff8e00cab5bd51f833",
+  ".claude/settings.json": "78922a784ee78e9e50587e93628cd3b9d4dfbe49087adc4514e6781cea38cbb9",
+  ".gitignore": "93ad7821acce7a08b523cc3cae78af1baf10e049f0d82b12ca2d45497454597e",
+  ".rlsbl/hooks/pre-checks.sh": "60c57d4563263124530e6f33aca77550ea2161ad3b33b3ba6ad1c03fea9eb6e2",
+  ".rlsbl/lint/python.toml": "9cfbcef2e010d5fad243437bf2fd8df54a1fae70ee0762f9d11da70fe207501c",
+  ".rlsbl/lint/go.toml": "807d5cf760baad6d571a5bfd43cb163efe356f7462ba9f1918d72de45f62339f",
+  ".rlsbl/lint/npm.toml": "baa36014e65923d8cc5c8b83c77fa651da79351627570476402da66840027645",
+  ".rlsbl/changes/unreleased.jsonl": "e3b0c44298fc1c149afbf4c8996fb92427ae41e4649b934ca495991b7852b855"
+}

selfdoc-0.4.2/.rlsbl/hooks/pre-checks.sh

@@ -0,0 +1,5 @@
+#!/usr/bin/env bash
+set -euo pipefail
+# This hook runs BEFORE built-in pre-release checks (tests, lint).
+# Use it for setup tasks: starting services, setting env vars, etc.
+# Built-in checks run after this hook. Custom validation goes in pre-release.sh.

{selfdoc-0.4.0 → selfdoc-0.4.2}/.rlsbl/hooks/pre-release.sh

@@ -1,8 +1,4 @@
 #!/usr/bin/env bash
-# Pre-release validation hook.
-# Runs before rlsbl creates a release. Exit non-zero to abort.
-# Detects project type and runs appropriate checks automatically.
-
 set -euo pipefail
 
 echo "Running pre-release checks..."