Artifact ce134a33b0e8b1a0017110de2ef0553e052378e048b461102282edd72bea5fb9:
- Executable file
.githooks/pre-commit
— part of check-in
[e2a2f28861]
at
2026-04-26 07:52:11
on branch trunk
— docs site + landing + Cloudflare auto-deploy (#6)
* design: docs site + landing page + Cloudflare auto-deploy
Mirror dagnats's docs/landing infrastructure for libfossil: a single-page landing at site/index.html (forked CSS/HTML, content rewritten), a Hugo + Hextra docs site at docs/site/, gomarkdoc-generated SDK reference under docs/site/content/docs/reference/sdk/, llms.txt artifacts, and a wrangler.jsonc that lets Cloudflare's git integration auto-deploy on push to main. Existing docs/*.md files move under docs/site/content/docs/.
* design: correct landing-page path to Hugo layout override
dagnats's working landing page lives at docs/site/layouts/index.html (a Hugo home-page layout override), not at site/index.html. The top-level site/index.html in dagnats is an older draft that the build pipeline ignores. Match the working setup.
* design: align visual system + section list with live dagnats landing
The earlier description came from dagnats's stale top-level site/index.html (JetBrains Mono + Instrument Serif italic + ember/teal accents, 8 sections). The live Hugo layout that actually serves at / uses Geist Mono only, prefers-color-scheme dual-mode (warm cream / warm dark), a single ember accent, and 7 sections (Install, What it is, Why you might want it, How it fits together, Compared to neighbors, What it is not, Get going). Update the spec to match what we are actually mirroring.
* design: drop SDK regen from CF build to match dagnats exactly
Earlier draft had CF install Go + gomarkdoc and re-run docs-gen-sdk on every deploy. dagnats does not do that; it relies on the pre-commit hook to keep committed SDK pages in sync, and ships only Hugo + llms-gen + hugo --minify in the CF build. Match that: smaller, faster CF build, no Go-runtime assumption about Workers Builds, and a true 1:1 mirror.
* plan: docs site + landing + CF auto-deploy implementation steps
11 tasks covering Hugo+Hextra bootstrap, content moves, gomarkdoc SDK generation with pre-commit drift check, llms.txt artifacts, Makefile targets, landing page fork from dagnats's live Hugo home layout, wrangler.jsonc for CF Workers Static Assets, README update, and PR creation.
* docs(site): bootstrap Hugo + Hextra skeleton
* docs(site): move existing docs into Hugo content tree
* docs(site): fix links + H1s broken by docs-tree move
- Drop .md extensions on Hugo cross-doc links - Switch source-code references to absolute github.com/danmestas/libfossil URLs (relative ../ paths broke when files moved 3 dirs deeper) - Align H1 of architecture.md and migration-from-fossil.md with their frontmatter titles
* docs(site): add quickstart, examples, and SDK section stubs
* docs(site): tighten quickstart snippets + reference index
- Make the Sync example self-contained (open + sync, full main, real signatures) - Bridge from Clone to Open with a one-line prose link - Add a sentence to reference/_index.md so it does not render blank - Use the project's canonical "pure-Go, CGo-free" phrasing
* docs(site): add docs-gen-sdk Makefile target + commit generated SDK pages
* docs(site): pin gomarkdoc version + replace empty driver stubs with prose
- Add GOMARKDOC_VERSION Makefile variable so contributors don't drift on output format when a new gomarkdoc ships - Drop the two driver packages (modernc, ncruces) from gomarkdoc and hand-write _index.md pages explaining the register-on-import contract; the stubs were byte-stable but rendered as visibly broken documentation
* docs(site): add gen-llms-txt.sh + docs-gen-llms target
* docs(site): switch llms-full frontmatter strip from sed to awk
The sed range-negation pattern '/^---$/,/^---$/!p' silently re-opens a suppression range on any bare '---' in body content, eating Markdown horizontal rules and embedded YAML in fenced code blocks. The awk pattern strips the frontmatter only when it begins on line 1, leaving body content intact regardless of how many '---' lines it contains.
* hooks: pre-commit fails when SDK pages drift from code
* hooks: pre-commit re-installs gomarkdoc if it's the wrong version
The drift check's existing gate just looks for gomarkdoc on PATH. A contributor with an older gomarkdoc installed locally would have the gate pass and then run regeneration with their stale binary, producing either a silent false-negative or a confusing OUT-OF-DATE error with no version hint. Compare the installed version against GOMARKDOC_VERSION from Makefile and re-install on mismatch. Best-effort; offline contributors can still commit.
* docs(site): add docs-serve, docs-build, docs aggregate targets
* docs(site): make docs aggregate parallel-safe via explicit deps
The docs aggregate previously listed gen-sdk, gen-llms, and build as side-by-side prereqs. Make doesn't guarantee left-to-right ordering under -j, and gen-llms reads what gen-sdk writes, while build reads both. Encode the chain explicitly so 'make -j docs' is correct. Side benefit: 'make docs-build' standalone now produces a complete deployable site, matching contributor expectation.
* site(landing): fork dagnats home layout; rebrand chrome
* site(landing): rewrite §01–§07 content for libfossil
* site(landing): use .ascii class for diagram + fix §03 phrasing
* deploy: add wrangler.jsonc for CF Workers Static Assets
* docs: point README at the new docs site (user: [email protected], size: 2569) [annotate] [blame] [check-ins using]
#!/bin/sh # libfossil pre-commit hook # Runs tests with both SQLite drivers + DST + OTel sub-module (~45s) before every commit. # # Install: git config core.hooksPath .githooks # Skip: git commit --no-verify (emergency only) set -e run_test() { label="$1" shift if output=$("$@" 2>&1); then echo " $label: OK" else echo " $label: FAILED" echo "" echo "$output" echo "" exit 1 fi } echo "=== pre-commit: modernc (default) ===" run_test "unit tests" go test ./... -short -count=1 -timeout=120s echo "=== pre-commit: ncruces ===" run_test "unit tests (ncruces)" go test -tags test_ncruces ./... -short -count=1 -timeout=120s echo "=== pre-commit: vet ===" run_test "go vet" go vet ./... echo "=== pre-commit: observer/otel ===" run_test "otel sub-module" sh -c "cd observer/otel && GOWORK=off go test ./... -short -count=1 -timeout=30s" echo "=== pre-commit: build libfossil binary ===" run_test "cmd/libfossil" go build ./cmd/libfossil/ echo "=== pre-commit: docs SDK drift ===" # Skip gracefully if gomarkdoc cannot be installed (fresh clone, offline, etc.). # Use the pinned version from Makefile so the check is deterministic across environments. GOMARKDOC_VERSION=$(awk -F':= *' '/^GOMARKDOC_VERSION/ {print $2; exit}' Makefile 2>/dev/null) GOMARKDOC_VERSION=${GOMARKDOC_VERSION:-latest} if ! command -v gomarkdoc >/dev/null 2>&1; then if ! go install "github.com/princjef/gomarkdoc/cmd/gomarkdoc@${GOMARKDOC_VERSION}" 2>/dev/null; then echo " gomarkdoc: SKIPPED (install failed; commit allowed)" fi else # Reinstall if locally-installed gomarkdoc is the wrong version. Best-effort; # tolerate failure so contributors can commit offline. Note: gomarkdoc --version # output format is e.g. "gomarkdoc v1.1.0"; we extract the last whitespace-separated token. _gm_installed=$(gomarkdoc --version 2>/dev/null | awk '{print $NF}') if [ "$_gm_installed" != "$GOMARKDOC_VERSION" ] && [ "$GOMARKDOC_VERSION" != "latest" ]; then go install "github.com/princjef/gomarkdoc/cmd/gomarkdoc@${GOMARKDOC_VERSION}" >/dev/null 2>&1 || true fi fi if command -v gomarkdoc >/dev/null 2>&1; then if make -s docs-gen-sdk >/dev/null 2>&1; then if git diff --quiet -- docs/site/content/docs/reference/sdk; then echo " SDK pages: in sync" else echo " SDK pages: OUT OF DATE" echo "" echo " Run 'make docs-gen-sdk' and commit the result." echo "" git diff --stat -- docs/site/content/docs/reference/sdk exit 1 fi else echo " docs-gen-sdk: SKIPPED (target not available)" fi fi echo "=== pre-commit: all passed ==="