+
+ );
+}
+
+// ── One ledger row ─────────────────────────────────────────────────────────
+function LedgerRow({
+ index,
+ title,
+ desc,
+ terminal,
+}: {
+ index: string;
+ title: React.ReactNode;
+ desc: React.ReactNode;
+ terminal: React.ReactNode;
+}): React.JSX.Element {
+ return (
+
+
+
+
+
+ {filename}
+
+
+
+ {children}
+
+
+
+ );
+}
+
+// ── The Obsidian Engineering Ledger ───────────────────────────────────────
+export default function EngineeringLedger(): React.JSX.Element {
+ return (
+
+
+ {index}
+
+
+ + {title} +
+{desc}
+{terminal}
+
+ {/* Section header */}
+ Zero Assumptions at System Boundaries
+ }
+ desc={
+
+ Every public entry point validates its inputs at the boundary. Internal hot paths
+ carry no defensive checks — the shape is guaranteed by the type system, enforced by
+ mypy --strict on every merge.
+
+ }
+ terminal={
+
+
+ }
+ />
+
+ {/* ── 02 — Subprocess-Free ──────────────────────────────────────── */}
+ Subprocess-Free Analysis}
+ desc={
+
+ Production-grade tools do not shell out during analysis. No subprocess.run(), no
+ os.system() inside per-item loops. Zenzic validates your documentation stack without
+ executing it.
+
+ }
+ terminal={
+
+
+ }
+ />
+
+ {/* ── 03 — Deterministic Dependency Graph ───────────────────────── */}
+ Deterministic Dependency Graph
+ }
+ desc={
+
+ Every dependency is pinned in a lockfile, audited by Dependabot, and scanned for
+ SPDX licence compatibility. No transitive surprises at release time. uv lock and
+ reuse lint run on every commit.
+
+ }
+ terminal={
+
+
+ }
+ />
+
+
+
+
+
+
+ {/* ── 01 — Zero Assumptions ─────────────────────────────────────── */}
+
+
+ Three invariants enforced on every commit. {' '}
+
+ No exceptions. No shortcuts.
+
+
+
+
+
+ {`[tool.mypy]
+strict = true
+warn_return_any = true
+warn_unreachable = true
+
+# Every public function has a typed signature.
+# Every Any must be justified in a comment.`}
+
+
+
+
+ {`# ✓ ALLOWED — single setup phase
+class ZenzicEngine:
+ def __init__(self, config: Config):
+ self._vsm = build_vsm(config) # I/O once
+
+# ✗ BLOCKED — subprocess inside analysis loop
+for page in corpus:
+ subprocess.run([...]) # ← architectural defect`}
+
+
+
+
+ {`# runs on every commit via pre-commit
+nox -s reuse
+
+✓ SPDX headers present │ all source files
+✓ Apache-2.0 declared │ LICENSES/
+✓ Third-party notices │ NOTICE
+# No dependency ships
+# without a licence audit.`}
+
+
+
- High-performance linter
+ The Safe Harbor
- for Markdown.
+ for Markdown Documentation.
-
+
Get started
-
+
View on GitHub
diff --git a/src/components/Homepage/QualityScore.tsx b/src/components/Homepage/QualityScore.tsx
index 6c50be1..c8f8e37 100644
--- a/src/components/Homepage/QualityScore.tsx
+++ b/src/components/Homepage/QualityScore.tsx
@@ -39,6 +39,9 @@ export default function QualityScore(): React.JSX.Element {
+// SPDX-License-Identifier: Apache-2.0
+import React from 'react';
+import Link from '@docusaurus/Link';
+import useBaseUrl from '@docusaurus/useBaseUrl';
+import Translate from '@docusaurus/Translate';
+
+export default function Quickstart(): React.JSX.Element {
+ const docsHref = useBaseUrl('/docs/');
+
+ return (
+
+
+ );
+}
diff --git a/src/components/Homepage/SentinelSection.tsx b/src/components/Homepage/SentinelSection.tsx
index 5067e61..f06974d 100644
--- a/src/components/Homepage/SentinelSection.tsx
+++ b/src/components/Homepage/SentinelSection.tsx
@@ -6,6 +6,9 @@ export default function SentinelSection(): React.JSX.Element {
+
@@ -73,18 +76,18 @@ export default function QualityScore(): React.JSX.Element {
Internal Links Health} value="99" />
diff --git a/src/components/Homepage/Quickstart.tsx b/src/components/Homepage/Quickstart.tsx
new file mode 100644
index 0000000..9fbd5a2
--- /dev/null
+++ b/src/components/Homepage/Quickstart.tsx
@@ -0,0 +1,105 @@
+// SPDX-FileCopyrightText: 2026 PythonWoods
+
Quality Score
@@ -73,18 +76,18 @@ export default function QualityScore(): React.JSX.Element {
- Anchor stability } value="28" />
- External references } value="16" />
+ Anchor stability } value="100" />
+ External references } value="97" />
- Orphan Detection} value="21" />
+ Orphan Detection} value="95" />
- Unused Assets } value="12" />
- Nav Isolation } value="9" />
+ Unused Assets } value="91" />
+ Nav Isolation } value="100" />
+ {/* Label */}
+
+
+
+
+
+
+ From zero to documentation integrity in one command.
+
+
+
+
+ {/* macOS window chrome */}
+
+
+ {/* Action buttons */}
+
+
+
+
+
+ zenzic · quickstart
+
+
+
+ {/* Commands */}
+
+ {/* Shell ready line */}
+
+
+ ✓
+ zenzic 0.6.1 · python 3.12 · ready
+
+ + # explore the interactive lab (9 acts, zero setup) +
+
+
+ $
+
+ uvx zenzic lab
+
+ + # audit your documentation right now +
+
+
+ $
+
+ uvx zenzic check all .
+
+
+
+ {/* GitHub icon */}
+
+ Star on GitHub
+
+
+
+ Read the full docs →
+
+
+
+
diff --git a/src/css/homepage.css b/src/css/homepage.css
index 5eed141..2d7b550 100644
--- a/src/css/homepage.css
+++ b/src/css/homepage.css
@@ -25,3 +25,8 @@
.zz-homepage a:hover {
text-decoration: none;
}
+
+/* Smooth scroll for the #quickstart anchor */
+.zz-homepage {
+ scroll-behavior: smooth;
+}
diff --git a/src/pages/index.tsx b/src/pages/index.tsx
index f22731c..8a5314c 100644
--- a/src/pages/index.tsx
+++ b/src/pages/index.tsx
@@ -4,29 +4,53 @@ import Layout from '@theme/Layout';
import '@site/src/css/homepage.css';
import Hero from '../components/Homepage/Hero';
-import Features from '../components/Homepage/Features';
+import EngineeringLedger from '../components/Homepage/EngineeringLedger';
import SentinelSection from '../components/Homepage/SentinelSection';
import QualityScore from '../components/Homepage/QualityScore';
+import Quickstart from '../components/Homepage/Quickstart';
export default function Home(): React.JSX.Element {
return (
+
Sentinel in Action
diff --git a/src/css/homepage.css b/src/css/homepage.css
index 5eed141..2d7b550 100644
--- a/src/css/homepage.css
+++ b/src/css/homepage.css
@@ -25,3 +25,8 @@
.zz-homepage a:hover {
text-decoration: none;
}
+
+/* Smooth scroll for the #quickstart anchor */
+.zz-homepage {
+ scroll-behavior: smooth;
+}
diff --git a/src/pages/index.tsx b/src/pages/index.tsx
index f22731c..8a5314c 100644
--- a/src/pages/index.tsx
+++ b/src/pages/index.tsx
@@ -4,29 +4,53 @@ import Layout from '@theme/Layout';
import '@site/src/css/homepage.css';
import Hero from '../components/Homepage/Hero';
-import Features from '../components/Homepage/Features';
+import EngineeringLedger from '../components/Homepage/EngineeringLedger';
import SentinelSection from '../components/Homepage/SentinelSection';
import QualityScore from '../components/Homepage/QualityScore';
+import Quickstart from '../components/Homepage/Quickstart';
export default function Home(): React.JSX.Element {
return (
-
+
+
+
+
+
+
+
+
+