docs: close OKF conformance gaps found by night audit
- references/okf-spec.md: replace v0.2 note with the deltas verified against upstream SPEC.md 2026-10-19 (timestamp->generated.at and # Citations->sources are the two breaking changes; trust fields and root-index okf_version are additive; bundle stays v0.1). - index.md: restore the agentic-web-research section lost in the 2026-08-28 rebuild and link log.md (index-coverage doctrine). - gen-keybinds.sh emits OKF frontmatter so its generated artifact (tools/niri/keybindings.md, regenerated, 120 bindings) passes kb-lint; test added red->green. - fix the two broken [[niri]] wikilinks (handy, noctalia-shell). Refs #29
This commit is contained in:
1 parent
01d9d3fbd5
commit
e86e60af39
8 files changed
+98
-12
No files matched your search
@@ -48,7 +48,17 @@ Practice notes: SDLC, languages, infra tooling (Terraform, K8s, containers).
|
||||
Decision-support research: agentic web tooling, chezmoi evaluation,
|
||||
secrets-for-agents. Research docs inform decisions; they are not facts yet.
|
||||
|
||||
## [Agentic web research](agentic-web-research/index.md)
|
||||
|
||||
Self-hosted web-agent stack research: SearXNG tuning, VPN routing, agentic
|
||||
search practices, open models, MCP.
|
||||
|
||||
## [Inventory](inventory/index.md)
|
||||
|
||||
Pre-pruning census of every userspace config on this box — the input for the
|
||||
pruning session.
|
||||
|
||||
## [Change history](log.md)
|
||||
|
||||
Chronological update history of this bundle — incident lessons land here first,
|
||||
then settle into concept pages.
|
||||
@@ -8,11 +8,20 @@ tags:
|
||||
- documentation
|
||||
- knowledge-bundle
|
||||
- specification
|
||||
verified: 2026-08-28
|
||||
verified: 2026-10-19
|
||||
timestamp: 2026-01-15
|
||||
---
|
||||
|
||||
> **Note:** Google Cloud published OKF v0.2 at [GoogleCloudPlatform/open-knowledge-format](https://github.com/GoogleCloudPlatform/open-knowledge-format) with additional frontmatter families for provenance, trust, and attestation. This document covers the v0.1 format used by this knowledge bundle.
|
||||
> **Note:** Google Cloud published OKF v0.2 at
|
||||
> [GoogleCloudPlatform/open-knowledge-format](https://github.com/GoogleCloudPlatform/open-knowledge-format)
|
||||
> (SPEC.md, verified 2026-10-19). v0.2 is a minor bump with two deliberate
|
||||
> breaking changes: `timestamp` is superseded by `generated: { by, at }`, and the
|
||||
> body `# Citations` list is superseded by a `sources` frontmatter family; it adds
|
||||
> optional trust/lifecycle fields (`verified: { by, at }`, `status`,
|
||||
> `stale_after`) and the `Attested Computation` type, and permits `okf_version:`
|
||||
> frontmatter in a bundle-root `index.md`. This bundle stays on v0.1 semantics
|
||||
> (kb-lint enforces them); the bundle-local `verified:` date stamp and `tags`
|
||||
> discipline are producer extensions compatible with both versions.
|
||||
|
||||
# Open Knowledge Format (OKF) v0.1
|
||||
|
||||
|
||||
@@ -229,5 +229,5 @@ See [[noctalia-shell]] for IPC integration patterns.
|
||||
## See Also
|
||||
|
||||
- [[noctalia-shell|noctalia-shell.md]] — Desktop environment integration
|
||||
- [[niri|niri/index.md]] — Compositor configuration
|
||||
- [niri](niri/index.md) — Compositor configuration
|
||||
- [`handy --help`](https://github.com/cjpais/Handy) — CLI reference
|
||||
@@ -1,3 +1,13 @@
|
||||
---
|
||||
type: reference
|
||||
title: Niri Keybindings
|
||||
description: Live keybinding cheat sheet generated from keybinds.kdl — do not edit by hand.
|
||||
tags:
|
||||
- niri
|
||||
- keybindings
|
||||
generated: { by: scripts/gen-keybinds.sh }
|
||||
---
|
||||
|
||||
# Niri Keybindings
|
||||
|
||||
> GENERATED by `scripts/gen-keybinds.sh` from `keybinds.kdl` — do not edit by hand.
|
||||
@@ -64,10 +74,10 @@
|
||||
| `Mod+K` | focus-window-up |
|
||||
| `Mod+Down` | focus-window-down |
|
||||
| `Mod+J` | focus-window-down |
|
||||
| `Mod+CTRL+Left` | swap-window-left |
|
||||
| `Mod+CTRL+H` | swap-window-left |
|
||||
| `Mod+CTRL+Right` | swap-window-right |
|
||||
| `Mod+CTRL+L` | swap-window-right |
|
||||
| `Mod+CTRL+Left` | consume-or-expel-window-left |
|
||||
| `Mod+CTRL+H` | consume-or-expel-window-left |
|
||||
| `Mod+CTRL+Right` | consume-or-expel-window-right |
|
||||
| `Mod+CTRL+L` | consume-or-expel-window-right |
|
||||
| `Mod+CTRL+Alt+Left` | move-column-left |
|
||||
| `Mod+CTRL+Alt+H` | move-column-left |
|
||||
| `Mod+CTRL+Alt+Right` | move-column-right |
|
||||
@@ -141,10 +151,10 @@
|
||||
| `Mod+CTRL+F` | expand-column-to-available-width |
|
||||
| `Mod+C` | center-column |
|
||||
| `Mod+CTRL+C` | center-visible-columns |
|
||||
| `Mod+Minus` | set-column-width "-10%" |
|
||||
| `Mod+Equal` | set-column-width "+10%" |
|
||||
| `Mod+Shift+Minus` | set-window-height "-10%" |
|
||||
| `Mod+Shift+Equal` | set-window-height "+10%" |
|
||||
| `Mod+Minus` | set-column-width "-5%" |
|
||||
| `Mod+Equal` | set-column-width "+5%" |
|
||||
| `Mod+Shift+Minus` | set-window-height "-5%" |
|
||||
| `Mod+Shift+Equal` | set-window-height "+5%" |
|
||||
|
||||
## Modes
|
||||
|
||||
|
||||
@@ -429,7 +429,7 @@ noctalia msg templates-apply
|
||||
|
||||
## See Also
|
||||
|
||||
- [[niri|niri/index.md]] — Compositor configuration
|
||||
- [niri](niri/index.md) — Compositor configuration
|
||||
- [[displays|displays]] — Display layout
|
||||
- [[cachyos|cachyos]] — Operating system documentation
|
||||
- [`noctalia msg --help`](https://github.com/Noctalia/noctalia) — Full command reference
|
||||
Reference in new issue
Block a user