Initial curated itworx-knowledge-hub source from 3b1751d0d9dee551aa6994eee0093704dc334817

tools/leafwiki-inspector/README.md

@@ -0,0 +1,42 @@
+# Read-only LeafWiki inspector
+
+This standard-library Python utility inventories a LeafWiki snapshot before an import
+adapter is selected.
+
+It does **not** import data and does not assume a fixed LeafWiki schema.
+
+## Usage
+
+```bash
+python tools/leafwiki-inspector/inspect.py /read-only/leafwiki-snapshot \
+  --output artifacts/leafwiki-inspection.json
+```
+
+Optional:
+
+```bash
+python tools/leafwiki-inspector/inspect.py /snapshot --include-root-path
+```
+
+The default report omits the absolute source root. It includes:
+
+- deterministic file manifest and SHA-256 fingerprint;
+- Markdown metadata and wiki-link targets;
+- SQLite schema/table/column/index/foreign-key inventory;
+- SQLite row counts without reading page bodies into the report;
+- JSON top-level keys;
+- asset/unknown counts;
+- symlink descriptors and escape warnings;
+- diagnostics.
+
+## Safety
+
+- The utility never writes under the source root.
+- SQLite is opened with `mode=ro&immutable=1` and `PRAGMA query_only`.
+- Symlinks are recorded but not followed.
+- Output defaults to stdout or a path outside the source.
+- It does not “repair” malformed Markdown or databases.
+- A hash fingerprint should be captured before and after every later migration.
+
+This tool is a discovery aid. The final importer and versioned adapters are implemented in
+M4 according to `docs/17-leafwiki-migration.md`.