selfdoc 0.5.2__tar.gz → 0.7.0__tar.gz

selfdoc-0.7.0/.rlsbl/changes/.validated

@@ -0,0 +1 @@
+ad41660337afb7f0b5bd92a6ba166cb873b9b4d5

selfdoc-0.7.0/.rlsbl/changes/0.5.2.md

@@ -0,0 +1,5 @@
+## 0.5.2
+
+### Fixes
+
+- **CLI page preservation fix end-to-end.** Handwritten CLI page descriptions now actually survive `selfdoc gen` (the 0.5.1 preservation logic was defeated by stale-file cleanup deleting CLI pages before they could be read for preservation).

selfdoc-0.7.0/.rlsbl/changes/0.6.0.jsonl

@@ -0,0 +1,12 @@
+{"commits":["ffd2e1f4031f62d5344292a84c614e41f468892a"],"user_facing":false}
+{"commits":["379ba6e08cc06fc4ab0161dcb2671c951dac3093"],"user_facing":false}
+{"commits":["8b64f528432988cfa4b579909b1e78a86ee3e52a","b5acfe9daa4454a4bf29cb76ae1008430772e643"],"user_facing":false}
+{"commits":["4b1db6378937c6bbea82b100623f2992847cd761","fb4f1779cc771becb9ab4c674f03ab65e9dcb3ef"],"user_facing":false}
+{"commits":["ed73a66a3254fa8d6a1c6f0ab8c9b5dd45c76004","34bfab4e2a32026c6430fdeb7d8dbc945014c496","ec8e8b19371c266ccdde35b58e33853fd1054ac6","f52a0b0413f6d6e7387b76597371713a4d09f41a"],"user_facing":true,"description":"**Declarative config schema.** Config validation is now driven by a schema (FieldType enum + FieldSpec dataclass) instead of procedural code. Unknown top-level keys in selfdoc.json are now rejected.","type":"feature"}
+{"commits":["74354656224c2f339357b56ec378f03c813e1a5e","1b76129ad004fdc44a548ec61cc5b6f13878970a"],"user_facing":true,"description":"**Five new directives.** `list-modules`, `table-commands`, `table-directives`, `table-config-schema`, and `var` for generating module lists, CLI command tables, directive catalogs, config reference tables, and project metadata interpolation.","type":"feature"}
+{"commits":["6edcd4741a1dc09af29b0311d32f1762939ceae9","29bf767d81407a7d6e07ead4bb61ac308c1c53d8","12627ed47a61820c36f22e476360ed2f4cdf4d69","d1b6c6b7c973da39ca3c14dd6546fb3a8d45a353"],"user_facing":true,"description":"**Root file generation.** `selfdoc gen` can now produce root-level Markdown files (CLAUDE.md, README.md, etc.) from underscore-prefixed templates in docs/. Configure via `root_files` in selfdoc.json. Generated files are read-only (0o444) with an auto-generated header.","type":"feature"}
+{"commits":["4feaf98c70d705f2a5dbeee246b8dd022d546365","f3b3570a6fbd2054af50fb7ed8f248ab78966c16","e6f09ead57c88403f2012105cb8406e1ecbe2f5b","cfc6b4256c28e19d66823bacf3bc0df30935a0e0"],"user_facing":false}
+{"commits":["28f48c9faee8dd0876c3acc30bd6e1b4cfcd37c1","c5dd07d5e434787e977839948e3698c5e1b6a78f","fc11f02005d45753ecbd5e52500ddee79f24d9b1"],"user_facing":false}
+{"commits":["fabfc6f4e82bf79ea14c52e3f793aceaab3395ad"],"user_facing":false}
+{"commits":["416002f8c8f593439fd3d98d9e9c993b6785fb68","7e25995dd928d6ae98d779be1a23e6a33a23b5d5"],"user_facing":false}
+{"commits":["3a19eb6185f43ffb5ee8f44364eb7066b69eec2f"],"user_facing":true,"description":"**Underscore-prefixed templates excluded from lint.** `selfdoc check` now skips `_*.md` files in docs/, matching the existing build exclusion.","type":"fix"}

selfdoc-0.7.0/.rlsbl/changes/0.6.0.md

@@ -0,0 +1,11 @@
+## 0.6.0
+
+### Features
+
+- **Declarative config schema.** Config validation is now driven by a schema (FieldType enum + FieldSpec dataclass) instead of procedural code. Unknown top-level keys in selfdoc.json are now rejected.
+- **Five new directives.** `list-modules`, `table-commands`, `table-directives`, `table-config-schema`, and `var` for generating module lists, CLI command tables, directive catalogs, config reference tables, and project metadata interpolation.
+- **Root file generation.** `selfdoc gen` can now produce root-level Markdown files (CLAUDE.md, README.md, etc.) from underscore-prefixed templates in docs/. Configure via `root_files` in selfdoc.json. Generated files are read-only (0o444) with an auto-generated header.
+
+### Fixes
+
+- **Underscore-prefixed templates excluded from lint.** `selfdoc check` now skips `_*.md` files in docs/, matching the existing build exclusion.

selfdoc-0.7.0/.rlsbl/changes/0.7.0.jsonl

@@ -0,0 +1,11 @@
+{"commits":["4662248eddc55e9a73f9df2138a03a602fbbb3c3","e0e4c7b9fab63d67264ea239b7f17e78b935e79b","fd56b8a2b3882aae1e7ac3d8e04b1b2a1da4e03a"],"user_facing":false}
+{"commits":["1617fc181590d677f6d9dd1b2fee678b5518e725","d13d1ff2acb197d6d9faf2f04cc2de6331f7f965","b9c5ca6ec417e6025bbd4819880c2a9c3af855d0"],"user_facing":true,"description":"**Shared resolution pipeline.** Directive resolution centralized in a single pass, eliminating redundant walks and double resolution in `selfdoc check`.","type":"feature"}
+{"commits":["87148a4d0a4186660d5a9786b98392b5aa0e5806","eac635d58ae294a7f849cbeaf5d032cdd9f00f88"],"user_facing":true,"description":"**`--dry-run` flag for `selfdoc check`.** Reports staleness without writing hashes or committing. Hash computation centralized in `staleness.py`.","type":"feature"}
+{"commits":["437989e14299d999587a465f126e24bfa7a76294"],"user_facing":true,"description":"**Glossary opt-out.** Set `\"glossary\": false` in selfdoc.json to suppress auto-generated glossary page. **Feed entry limit.** Set `\"feed_max_entries\": N` to limit the Atom feed to the N most recent pages.","type":"feature"}
+{"commits":["c44501f7b4dda858b9ddd1b5d32a865983fefdd7"],"user_facing":true,"description":"**Schema.json-based CLI extraction.** Replaced AST-based CLI structure extraction with reading `.strictcli/schema.json`. Richer data (flag choices, hidden flags, deprecated commands). Go projects get CLI documentation for the first time.","type":"feature"}
+{"commits":["a3c908e7786cbc2fc64828817da30361ac2bbc79"],"user_facing":true,"description":"**strictcli dependency bumped to >=0.7.0** for `--dump-schema` support.","type":"breaking"}
+{"commits":["83b5a988820d106ba75b894df092b99d0536340b","83f73d733b2792cb925258dba0a6ce9f2f9798dc","aadff49c75d6aa6116704e140704ed3891e8d1a4"],"user_facing":false}
+{"commits":["4d72c32453e32e86376f0e4a7a955888899931d3","0a38988185a90b9cf4c712ed8080182baf73732f","b49e973064c01b0978d582065c01ca524dea6dd3"],"user_facing":false}
+{"commits":["eacb35107670be3dd1c0495fe7368bc7392abff3"],"user_facing":false}
+{"commits":["b54e86870482f24e3a78405c8c300f0c98f39aea"],"user_facing":false}
+{"commits":["907abafbbb26de0936639cf29b2f44fbe9c437c9","2c17abf22cb3bd4e0e6179b8fed1faf34f153f70","93a1fe7d9ecdc0d3d59bc2db1617a1e674f57e3e"],"user_facing":false}

selfdoc-0.7.0/.rlsbl/changes/0.7.0.md

@@ -0,0 +1,12 @@
+## 0.7.0
+
+### Breaking
+
+- **strictcli dependency bumped to >=0.7.0** for `--dump-schema` support.
+
+### Features
+
+- **Shared resolution pipeline.** Directive resolution centralized in a single pass, eliminating redundant walks and double resolution in `selfdoc check`.
+- **`--dry-run` flag for `selfdoc check`.** Reports staleness without writing hashes or committing. Hash computation centralized in `staleness.py`.
+- **Glossary opt-out.** Set `"glossary": false` in selfdoc.json to suppress auto-generated glossary page. **Feed entry limit.** Set `"feed_max_entries": N` to limit the Atom feed to the N most recent pages.
+- **Schema.json-based CLI extraction.** Replaced AST-based CLI structure extraction with reading `.strictcli/schema.json`. Richer data (flag choices, hidden flags, deprecated commands). Go projects get CLI documentation for the first time.

{selfdoc-0.5.2 → selfdoc-0.7.0}/.rlsbl/hooks/pre-release.sh

@@ -3,6 +3,9 @@ set -euo pipefail
 
 echo "Running pre-release checks..."
 
+echo "  Updating CLI schema..."
+uv run selfdoc --dump-schema
+
 if [ -f go.mod ]; then
   echo "  Go: vet + build + test"
   go vet ./...

selfdoc-0.7.0/.rlsbl/version

@@ -0,0 +1 @@
+0.37.0

{selfdoc-0.5.2 → selfdoc-0.7.0}/.selfdoc/hashes/hashes.json

@@ -8,7 +8,7 @@
     "description": "8a4adace98aa9e1d61ec6b19dad2790d33bb9a7b6ccc435cfc9484ea22799bc8"
   },
   "cli-check.md": {
-    "content": "495266af4cc9c57cba5084443575781e5b8172adf934423eaa0a8f2246d0d9b6",
+    "content": "9b089d4ee112451eb379de9dfa9fa3cb69f4cd696a3ab83c4192af6cb8d7c7da",
     "description": "7ded848e80672d3121d55b1298869333328ceeb3bab2ed722fd190f4f36865dd"
   },
   "cli-deploy.md": {
@@ -44,11 +44,11 @@
     "description": "a06732d81dedac36b59c719e5e6ddb4f6e39b7250cb46cd8575ac4368d270663"
   },
   "directives.md": {
-    "content": "be302133f15cc289f055cd36dbd4f4c35afd16cbe22f86f9bfbd944d8acad8fa",
+    "content": "bbdfe1785fcce6cbe2c2744f4ccad7582b0e8ccdb6e2cfc9ba1efa303b3eb27f",
     "description": "17f2e9be72b960c7fb00f3b9bb0caa2d2323ff159d895d528150c2bd174934fb"
   },
   "gen-index.md": {
-    "content": "b9a34b4f67c1d3c80a949b39ec62bb6ffcc946f1b9c7efd1a3374b59518edd8e",
+    "content": "3327e75cd368e8fc574d2671ae6647b65bb178e8f011e3283d8e5c28e2a11bc2",
     "description": "bb3cd9d34f014c0674a9285c25ee14b5b4abc5cf941f0d83594c301405e8f3b6"
   },
   "getting-started.md": {
@@ -64,72 +64,84 @@
     "description": "be4881babd1a98706a694be1393b205768d475c98a6f715d7ec504c1382e25de"
   },
   "selfdoc-build.md": {
-    "content": "21a93bac9ec86685860f63d50cf78bc87951236530fdf0794709c4d52872352c",
-    "description": "7a72665df4c9aa9006d521bc606ac3603fd79789ae0c6e8c36374e3425c7e6bc"
+    "content": "a11d09883a9c002706f29b73af2d6c74cd579b55396bbc5709cd00b8c3e7fedb",
+    "description": "25ec3ea53419eb4126b309ad81d0c2e78e1347f29201a7f1574f6e38e90e4621"
   },
   "selfdoc-check.md": {
-    "content": "3c47444d8e3ae327c8dfc7f34cdbbe5fe44cd3a66c866d671882f93c93fc1d9f",
-    "description": "794a9326b6ca57477f223c7a5c92a4daf64558ee677ff16137592388e36a6ebd"
+    "content": "6ef700fd3e91926959ef099568ed293e17a4d4a686d26c7b857bb1819d3a3f0d",
+    "description": "a458cccd01e54fe1e2266244fbbc15683400273f7f951c31c1392bc998151d6d"
   },
   "selfdoc-cli.md": {
-    "content": "880355a1431236a3e4771ecad5bcbda7b20460cedaf1ae1332ea14e71b9858ab",
-    "description": "1ba311ee0ea7095ad80086e071e6f33c15506ea2aec8d92a3cdaee9b89137dbf"
+    "content": "02f7bd2cb044c46158e0123825beacafef4c9a02fe9bfa3ab97df174da6d3fcc",
+    "description": "ee2400812c86e36d0188ddc98abf76fe402479955e087db0b33b5016e1f500ad"
   },
   "selfdoc-config.md": {
-    "content": "9df82b5c322f48946bdac68f0bbfd2e8d8c4e2fe43112f31c7a1c871362ef7a7",
-    "description": "877235edacabac0e9d18e6bfba4418eaf61998a6167bf0bbcd7b548da13bd36b"
+    "content": "e6346ad8a4024c28d54073fa33287212152fe87e0363bc8d5951390d639368e4",
+    "description": "0de91696b5053d2d39f731671dc1cd70cc0b4c0150586abf30d3346ee0da952d"
   },
   "selfdoc-deploy.md": {
     "content": "d753004c1be5186890f34d42342bd4d4d9a0d35d45dc48eb74bb9eadf1036fe3",
-    "description": "32b71a5952b0e1d211b1a7d3ed98e7ef414b33474c43ffd37f13af3ab5bcee00"
+    "description": "93a17af98499afc17c0adb017c41e304783cc76f8f474b4656483f1d5ea3595a"
   },
   "selfdoc-directives.md": {
     "content": "284db842f12b44acc1a7e8b0d043571a0c587b59e474a13858291beb389484c3",
-    "description": "66c20577a5b0714037d09ca907481f4e500af42bdcaf2c1ceed818520d34e737"
+    "description": "4349c5d3d01b37655615897c7e8cf33df5aad10bfe4d4a99f4bee95947406e2c"
+  },
+  "selfdoc-docs.md": {
+    "content": "6a28a5a84ef39dce108b51e334d801a3de3090bf542e935dd78fd22efce534e8",
+    "description": "e62e4b7f625c67bc856dc0a3332930e942bf9a184a88cadcec5a34cc3d4e7f50"
   },
   "selfdoc-extractors-go.md": {
     "content": "614e2764a5fffe95125a4472336018bdc91f6509a87352eb7c8a5ef7f2e04469",
-    "description": "7a460a4f47e6dd0a90f88c6b4e490913bfa3f8b44c76ac45e7afceab755bdac9"
+    "description": "765787f8ad1d5011e0cc2990a0ac939663194d85ed56279ee7d37ccc49141e4a"
   },
   "selfdoc-extractors-python.md": {
     "content": "9171a5a26e52978d019369dea38d3b5aba843b3a99e8577e4a3b33de9a8a4782",
-    "description": "e4a810daa1f6ada057b7b2e6434b11909aaa244f8c742d4d4cc8aa3b41537546"
+    "description": "eee365e917adb22ebe95fd8ed6322cf23316bc777e88d0b503618f4b199358ff"
   },
   "selfdoc-extractors-typescript.md": {
     "content": "ed037150438ddcea03e17cb7d91d30dc0f957d2ee950decd914bf0f6b5da6cff",
-    "description": "e94ae996a8a87b8c66382bd0b03568180eeb0cf882db397defe34800910dd16f"
+    "description": "7b9cfae65be6a84e3612b5ccd5e4751053d1945f539b42050cd3d5031ee491a3"
   },
   "selfdoc-extractors.md": {
     "content": "585b695cab232ab64f87ef0b28c8547612e34192dbca6079a0eed522871d8cd1",
-    "description": "1ece1664561302314e740b7152cf3cc80b81b27cfdec00142e64beb6aa8cbd49"
+    "description": "f5f7ee5341943072e3d458ed7f3e03bf6ea9479ef2410ee2dc07deadd32bfadb"
   },
   "selfdoc-gen.md": {
-    "content": "cda2ade2e46df269791314f5eb86ddcf57b93eea09e404abb605b358cd732cb2",
-    "description": "8a73b5ffff03f37c5b5289d81eb4fc9b6fdb17234f68e3f45d712046fe492168"
+    "content": "35d948386f50c635ad876d973cbde438540c2a813bcbc0357661a580f2514aa7",
+    "description": "ab944a7d47b5ef1e0bdcab2670bbd62d3e0bc902798ad1ca10bc3c06c6e78be9"
   },
   "selfdoc-gendata.md": {
     "content": "54e9a0a6aee2b422ced3b860c872362c65d940dae28ba3d0b79c3117bc234b62",
-    "description": "6430b80740f48e37c397d5319d31c2678c29f9b7dc59ca58387a345d7c4b7e2e"
+    "description": "b808518c126f2f07a0b93986584b7fc20ae87cb76fc5f973b579c4066354a16d"
   },
   "selfdoc-html.md": {
-    "content": "0aaf85d3491540940f52d0a6584fe22d22822bf7239ef52b98355052e4686e18",
-    "description": "9d51466e9f880063e7acf362bfa98b6f8f8640dfb146a962615845d226553916"
+    "content": "3e2ffc99495e4af66ca02b7799c10bd7439fe8c869428c432a2fb808dca5d4c1",
+    "description": "e9c373874ce0bf9eaa4716a7b9a6f1e2ee94014b24f14c95df960e94cd780c59"
+  },
+  "selfdoc-icons.md": {
+    "content": "6d3a4944698f6bef54f3eccc01b221f0f09799a30006d9765dec7284dff72c46",
+    "description": "abfb38a84d98475211dd86e7621b5dd329d2189f88dcafa085a3d8299bd0da97"
   },
   "selfdoc-resolver.md": {
     "content": "4158312182ee977769882e9a4552ac2613f31bfa0dadb71be8bed0848861063d",
-    "description": "2c516b214162dfd2230961238bf5e8d3f8cf35c8838d57112addb8c19484a8b0"
+    "description": "273c26abce985442107be1fb321e5d51068124691b7631754cf0267af4c03adf"
   },
   "selfdoc-strictcli_support.md": {
-    "content": "1a2ca0ffff713e4aff94058cecf194342c24b7fcc15de2f50cf72db64a5de0dc",
+    "content": "b3bc7558fb379a83785e682d3696b79d93887b505e22b1986823d6afda24f3e1",
     "description": "ba21e34d05da48eae381df63dd5034745cbc1d5ce2d3cccf0b7a509cc89d4196"
   },
   "selfdoc-tokenizer.md": {
     "content": "46c221bfa3be2e7140ce503c11beda01355a8dccce26366ed612f476ef52371e",
-    "description": "a45cb451a64d7e774195c7dea890afd21d3e5b18679fcac212154b79f670f867"
+    "description": "d89fda0bd6354be7a60574c8cd7fa2433bcbaf315c8f165e3e06f904e9949589"
+  },
+  "selfdoc-utils.md": {
+    "content": "9279dc668ca705cc1a6c7bbcb7b8c356eac318b3a3d3bfcf63bca0b25921b067",
+    "description": "af261d72c93a904f34d57a84f012c8ab805532e62c581aa0361873265cf7680e"
   },
   "selfdoc.md": {
     "content": "740137aa79607266cf4710eda34a20f09e042eb59aa74d888e1ce1c21e49b8d4",
-    "description": "9cba9e52f4148dfa56b8f928b4f8d58783024d503e46b23d5de07451c186f12c"
+    "description": "878a8caa74c228e469b5a7ec4f769308f83ba4b2b21b568fcb6c38756d17b8e1"
   },
   "theming.md": {
     "content": "bb327170ca977b166a27223ee5ab21c8049fafc85f34519aeef10d1aac7e1506",

selfdoc-0.7.0/.strictcli/schema.json

@@ -0,0 +1,178 @@
+{
+  "name": "selfdoc",
+  "version": "0.6.0",
+  "help": "Code-aware static site generator with directive-based content extraction",
+  "env_prefix": null,
+  "config": false,
+  "global_flags": [],
+  "commands": {
+    "init": {
+      "name": "init",
+      "help": "Initialize selfdoc in the current project",
+      "flags": [
+        {
+          "name": "no-commit",
+          "type": "bool",
+          "help": "Skip auto-committing changed files",
+          "short": null,
+          "default": false,
+          "env": null,
+          "choices": null,
+          "repeatable": false,
+          "negatable": true,
+          "hidden": false
+        }
+      ],
+      "args": [],
+      "passthrough": false
+    },
+    "build": {
+      "name": "build",
+      "help": "Build the documentation site",
+      "flags": [
+        {
+          "name": "no-commit",
+          "type": "bool",
+          "help": "Skip auto-committing changed files",
+          "short": null,
+          "default": false,
+          "env": null,
+          "choices": null,
+          "repeatable": false,
+          "negatable": true,
+          "hidden": false
+        }
+      ],
+      "args": [],
+      "passthrough": false
+    },
+    "serve": {
+      "name": "serve",
+      "help": "Serve the documentation site locally",
+      "flags": [
+        {
+          "name": "port",
+          "type": "int",
+          "help": "Port to serve on (default: 8000)",
+          "short": "p",
+          "default": 8000,
+          "env": null,
+          "choices": null,
+          "repeatable": false,
+          "negatable": null,
+          "hidden": false
+        }
+      ],
+      "args": [],
+      "passthrough": false
+    },
+    "deploy": {
+      "name": "deploy",
+      "help": "Deploy the documentation site",
+      "flags": [],
+      "args": [],
+      "passthrough": false
+    },
+    "check": {
+      "name": "check",
+      "help": "Check documentation coverage and consistency",
+      "flags": [
+        {
+          "name": "ignore",
+          "type": "str",
+          "help": "Comma-separated SEO codes to suppress (e.g., SEO007,SEO008)",
+          "short": null,
+          "default": "",
+          "env": null,
+          "choices": null,
+          "repeatable": false,
+          "negatable": null,
+          "hidden": false
+        },
+        {
+          "name": "format",
+          "type": "str",
+          "help": "Output format (default: text)",
+          "short": null,
+          "default": "text",
+          "env": null,
+          "choices": [
+            "text",
+            "json"
+          ],
+          "repeatable": false,
+          "negatable": null,
+          "hidden": false
+        },
+        {
+          "name": "no-commit",
+          "type": "bool",
+          "help": "Skip auto-committing changed files",
+          "short": null,
+          "default": false,
+          "env": null,
+          "choices": null,
+          "repeatable": false,
+          "negatable": true,
+          "hidden": false
+        },
+        {
+          "name": "dry-run",
+          "type": "bool",
+          "help": "Report staleness without writing hashes",
+          "short": null,
+          "default": false,
+          "env": null,
+          "choices": null,
+          "repeatable": false,
+          "negatable": true,
+          "hidden": false
+        }
+      ],
+      "args": [],
+      "passthrough": false
+    },
+    "gen": {
+      "name": "gen",
+      "help": "Auto-generate documentation pages from project structure",
+      "flags": [
+        {
+          "name": "no-commit",
+          "type": "bool",
+          "help": "Skip auto-committing changed files",
+          "short": null,
+          "default": false,
+          "env": null,
+          "choices": null,
+          "repeatable": false,
+          "negatable": true,
+          "hidden": false
+        }
+      ],
+      "args": [],
+      "passthrough": false
+    },
+    "gen-data": {
+      "name": "gen-data",
+      "help": "Generate data files by running sandboxed scripts",
+      "flags": [
+        {
+          "name": "no-commit",
+          "type": "bool",
+          "help": "Skip auto-committing changed files",
+          "short": null,
+          "default": false,
+          "env": null,
+          "choices": null,
+          "repeatable": false,
+          "negatable": true,
+          "hidden": false
+        }
+      ],
+      "args": [],
+      "passthrough": false
+    }
+  },
+  "groups": {},
+  "deprecated": {}
+}

{selfdoc-0.5.2 → selfdoc-0.7.0}/CHANGELOG.md

@@ -2,6 +2,31 @@
 
 # Changelog
 
+## 0.7.0
+
+### Breaking
+
+- **strictcli dependency bumped to >=0.7.0** for `--dump-schema` support.
+
+### Features
+
+- **Shared resolution pipeline.** Directive resolution centralized in a single pass, eliminating redundant walks and double resolution in `selfdoc check`.
+- **`--dry-run` flag for `selfdoc check`.** Reports staleness without writing hashes or committing. Hash computation centralized in `staleness.py`.
+- **Glossary opt-out.** Set `"glossary": false` in selfdoc.json to suppress auto-generated glossary page. **Feed entry limit.** Set `"feed_max_entries": N` to limit the Atom feed to the N most recent pages.
+- **Schema.json-based CLI extraction.** Replaced AST-based CLI structure extraction with reading `.strictcli/schema.json`. Richer data (flag choices, hidden flags, deprecated commands). Go projects get CLI documentation for the first time.
+
+## 0.6.0
+
+### Features
+
+- **Declarative config schema.** Config validation is now driven by a schema (FieldType enum + FieldSpec dataclass) instead of procedural code. Unknown top-level keys in selfdoc.json are now rejected.
+- **Five new directives.** `list-modules`, `table-commands`, `table-directives`, `table-config-schema`, and `var` for generating module lists, CLI command tables, directive catalogs, config reference tables, and project metadata interpolation.
+- **Root file generation.** `selfdoc gen` can now produce root-level Markdown files (CLAUDE.md, README.md, etc.) from underscore-prefixed templates in docs/. Configure via `root_files` in selfdoc.json. Generated files are read-only (0o444) with an auto-generated header.
+
+### Fixes
+
+- **Underscore-prefixed templates excluded from lint.** `selfdoc check` now skips `_*.md` files in docs/, matching the existing build exclusion.
+
 ## 0.5.2
 
 ### Fixes

selfdoc-0.7.0/CLAUDE.md

@@ -0,0 +1,65 @@
+<!-- Auto-generated by selfdoc from docs/_CLAUDE.md — do not edit -->
+
+# selfdocumenting
+
+Code-aware documentation site generator. Builds full static sites from Markdown templates and source code, with directive-based content extraction, auto-generated API/CLI reference pages, theming, search, SEO, and deploy to Cloudflare Pages or GitHub Pages. Supports Python, Go, and TypeScript/JavaScript.
+
+## Conventions
+
+- Pure Python, one runtime dependency (`strictcli>=0.2.0`)
+- Build system: hatchling
+- Development: `uv` for all Python tooling (`uv sync`, `uv run`, `uv add`)
+- Local development install: `uv pip install -e .`
+- npm package is a thin Node wrapper (`bin/cli.js`) that delegates to `python3 -m selfdoc`
+- File writes to shared state use atomic write (write to tmp, then `os.replace`)
+- External calls (subprocess, network) must have timeouts
+
+## Release workflow
+
+This project uses [rlsbl](https://github.com/smm-h/rlsbl) for release orchestration.
+
+- Update CHANGELOG.md with a `## X.Y.Z` entry describing changes
+- Run `rlsbl release [patch|minor|major]` to bump version and create a GitHub Release
+- CI handles publishing automatically via the publish workflow
+- Never publish manually -- always use `rlsbl release`
+- Requires NPM_TOKEN secret on GitHub (Settings > Secrets > Actions)
+- Use `rlsbl release --dry-run` to preview a release without making changes
+
+## Testing
+
+```bash
+uv run pytest
+```
+
+Tests live in `tests/` and cover config loading, directive parsing, the build pipeline, and language-specific extractors (Python, Go).
+
+## Architecture
+
+- **selfdoc** (`selfdoc/__init__.py`): selfdoc: Code-aware static site generator with directive-based content extraction.
+- **selfdoc.__main__** (`selfdoc/__main__.py`)
+- **selfdoc.build** (`selfdoc/build.py`): Build pipeline for selfdoc: template scanning, directive resolution, HTML output.
+- **selfdoc.catalog** (`selfdoc/catalog.py`): Directive catalog: defines all built-in directive names and their status.
+- **selfdoc.check** (`selfdoc/check.py`): Check command -- validate directives and report documentation coverage.
+- **selfdoc.cli** (`selfdoc/cli.py`): CLI interface for selfdoc.
+- **selfdoc.config** (`selfdoc/config.py`): Config loader for selfdoc.json.
+- **selfdoc.content** (`selfdoc/content.py`): Content directives -- directives that transform body content into styled HTML.
+- **selfdoc.deploy** (`selfdoc/deploy.py`): Deploy providers for selfdoc documentation sites.
+- **selfdoc.directives** (`selfdoc/directives.py`): Directive parser for selfdoc's structured marker syntax.
+- **selfdoc.docs** (`selfdoc/docs.py`): Shared resolution pipeline for docs/ templates.
+- **selfdoc.extractors** (`selfdoc/extractors/__init__.py`): Language extractor registry and auto-detection.
+- **selfdoc.extractors.base** (`selfdoc/extractors/base.py`): Shared utilities for language extractors.
+- **selfdoc.extractors.go** (`selfdoc/extractors/go.py`): Go source extractor -- resolves directives by extracting from .go files.
+- **selfdoc.extractors.protocol** (`selfdoc/extractors/protocol.py`): Language extractor protocol -- defines the interface all extractors must implement.
+- **selfdoc.extractors.python** (`selfdoc/extractors/python.py`): Python source extractor -- resolves directives by extracting from .py files.
+- **selfdoc.extractors.typescript** (`selfdoc/extractors/typescript.py`): TypeScript/JavaScript source extractor -- resolves directives by extracting from .ts/.js files.
+- **selfdoc.gen** (`selfdoc/gen.py`): Auto-generate documentation pages from project structure.
+- **selfdoc.gendata** (`selfdoc/gendata.py`): Generate data files by running sandboxed scripts via bubblewrap (bwrap).
+- **selfdoc.git** (`selfdoc/git.py`): Auto-commit helper for selfdoc commands.
+- **selfdoc.html** (`selfdoc/html.py`): Convert Markdown files to static HTML with a built-in minimal converter.
+- **selfdoc.icons** (`selfdoc/icons.py`): Language icons for code blocks.
+- **selfdoc.resolver** (`selfdoc/resolver.py`): Resolver factory -- dispatches directives to language-specific extractors.
+- **selfdoc.staleness** (`selfdoc/staleness.py`): Description staleness detection via content hashing.
+- **selfdoc.strictcli_support** (`selfdoc/strictcli_support.py`): First-class support for strictcli-based projects.
+- **selfdoc.themes** (`selfdoc/themes/__init__.py`): Theme registry for selfdoc.
+- **selfdoc.tokenizer** (`selfdoc/tokenizer.py`): Standalone Markdown block tokenizer.
+- **selfdoc.utils** (`selfdoc/utils.py`): Shared utility functions for selfdoc.