- Skills: descriptions cut to routing-hint length (1925w -> 840w), Trigger
phrases removed, Purpose collapsed, Edge cases moved to references/.
- Rule B names the decisions-log exception; "Sync the wiki" trigger dropped;
reserved sections "Four" -> "Three"; directory contract adds ckb.yaml,
docs/, tests/.
- MANUAL/CHANGELOG/OPENSPEC (EN+PL) moved to docs/; template ADRs D-0001 and
D-0002 restored from 0c06cb6 into docs/decisions/; referrers repointed.
- ckb-retrieve: rank fusion moved into scripts/retrieve_candidates.py;
Purpose states the one write it owns (query-gaps).
- tests/: fixture KB, golden JSON, smoke.sh.
- Scaffold: overview.md describes content not schema; graph/index.md names
base skills only; query-gaps.md loses its self-rotting freshness window.
- README/MANUAL/OPENSPEC/CHANGELOG ghost-writer pass in both languages.
- VERSION 1.9.0 -> 1.10.0.
Co-Authored-By: Claude Fable 5.1 <noreply@anthropic.com>
25 lines
1.3 KiB
Markdown
25 lines
1.3 KiB
Markdown
# ckb-export-okf — edge cases
|
|
|
|
Reference material for the `ckb-export-okf` skill. Read when a
|
|
run hits an unusual situation the main steps don't cover.
|
|
|
|
- **Empty `wiki/entities/` or `wiki/graph/`:** their `index.md` is still
|
|
regenerated, as an H1 with an empty bullet list. An empty index is
|
|
spec-valid; the directory is never skipped.
|
|
- **A future `wiki/<newtopic>/` subdirectory:** handled automatically — the
|
|
script discovers directories dynamically, mirrors them, and generates an
|
|
index for each. No script changes needed.
|
|
- **A future `wiki/archived/`:** exported like any other subdirectory. OKF
|
|
has no notion of archival status; `retention`/`freshness_window_days`
|
|
already ride along as extension fields for any consumer that cares.
|
|
- **Non-markdown files in `wiki/`** (e.g. `graph/edges.json`): copied
|
|
verbatim into the same relative position and listed in their directory's
|
|
index. Dotfiles (`.gitadd`) are skipped.
|
|
- **Re-running with no wiki changes:** produces byte-identical output — every
|
|
directory walk and generated list is sorted. If a run is ever
|
|
nondeterministic, that's a bug in the script, not expected behavior.
|
|
|
|
---
|
|
|
|
*Licensed under the Apache License, Version 2.0 — see [LICENSE](../../../LICENSE)
|
|
at the repository root, or <http://www.apache.org/licenses/LICENSE-2.0>.*
|