Fixes F17-F19 from the 2.0.0 script review:
- lint check 15 scans hidden folders, key files, dotfiles and
extensionless text; finds unquoted secret-looking assignments; reports
files over 50 MB instead of skipping them silently
- mcp: search filtered by the read policy, query after `--`,
case/trailing-dot-insensitive .local.yaml refusal, verified OAuth
email only, DNS-rebinding protection on by default, single-use codes
- capture: link-local/metadata always refused, private networks need
--allow-private (also on redirects), total download limit, charset
fallback and <meta charset>, <form> kept, svg title ignored, safe
collision-free binary names with dedup
Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Fixes F7-F11 from the 2.0.0 script review:
- UTF-8 stdout/stderr in every script; UTF-8 decoding of git/rg/yt-dlp
output and of hook stdin
- utf-8-sig reads, so BOM files keep their frontmatter
- fingerprints match LF or CRLF checkouts (lint, lint_quick.sh,
consolidate); prefix match on the full digest; short ones reported
- POSIX paths in lint output; rg --path-separator /
- hook installers default to the running interpreter, quote paths,
--check reports a missing interpreter, odd settings are an error
New tests/unit/test_windows.py.
Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Fixes F6, F12-F16 from the 2.0.0 script review:
- share: plain file/mailbox names and mailbox-bound share_id/version, or
the message is ignored (no ckb.yaml injection, no writes outside
raw/inbox/); ledger rejects whitespace/control characters; every
commit on a message must be by an owner; duplicate members.yaml
entries unown a mailbox; only verified retractions hide mail; branch,
url and name validated before git; received copy always untrusted;
<private> stripped from title/tldr and unclosed tags; no send without
the secret scan
- capture: frontmatter values quoted unless plainly safe; one-line title
- lint check 13: chat-attributed Crux needs no Sources
Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Fixes F1-F5 from the 2.0.0 script review:
- removeprefix/removesuffix (3.9+) replaced; lint, retrieve and
consolidate crashed on Python 3.8 with any graph edges
- routines.py --mark wrote `last_run:DATE` (invalid YAML) and swallowed
trailing comments into the value
- export_okf.py --out must be inside outputs/ (it is rmtree'd);
export_starlight.py image copies confined to wiki/assets/
- script counts in AGENTS.md, READMEs and manuals
New tests/unit/ (stdlib unittest, run from smoke.sh): 3.8 API guard,
routines round-trips, exporter containment, AGENTS.md consistency.
Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
New opt-in `share` module with skill `ckb-share` and stdlib `share.py`
(join/send/unshare/list/receive/status). KBs exchange documents through a
git channel with one append-only mailbox per KB; sends are packed
self-contained, secret-scanned and confirmed; received documents land in
raw/inbox/ (untrusted), retractions in raw/retractions/; the git author
must own the mailbox. dedup_inbox.py reports SAME SHARE; ckb-ingest and
ckb-retract know share files. Smoke test covers two KBs end to end.
Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
ABOUT.pl.md ships as the Polish scaffold next to ABOUT.md, like the other
.pl.md docs. Agents read both when both are filled in; ABOUT.md wins on a
conflict (AGENTS.md, ckb-ingest). ckb-init copies both and puts a Polish
answer in the Polish file; ckb-upgrade creates it once for KBs below
1.26.2; ckb-reset leaves it alone; the mcp server's kb_overview includes
it and its description ignores either placeholder. READMEs, QUICKSTART.pl,
both manuals and both changelogs updated.
Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
- F11 new opt-in module `capture` (skill ckb-capture, capture_url.py):
stdlib fetch with readable-text extraction, Wayback only over a failed
or thinner live page, --from-file for the agent's own fetch, PDFs saved
as files, --media via yt-dlp with consent, untrusted: true marking,
dedup at capture time; dedup_inbox.py now compares source_url (D-0017)
- F22 tests/run_evals.py (list/prepare/check/validate) and five
structural eval cases; reference run for ckb-decide/record
- F18 manual section with untested setups for Codex CLI, Cursor,
OpenCode and Gemini CLI, plus the Claude Code-only feature table;
AGENTS.md tells agents without skill loading to read SKILL.md
Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
- 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>
Graft keeps a derived, disposable code graph in sync with a content hash
rather than a calendar, and keeps a protected block on every regenerated
node. This KB is the opposite kind of store — durable, curated, built from
material that cannot be regenerated — but several of Graft's mechanisms
port cleanly, and two of them close real gaps here.
Schema 1.5 is additive: every 1.4 page remains valid.
1. `## Crux` — verbatim source excerpts alongside the synthesis. A summary
can drift silently; a quote either still matches its source or it does
not. Lets `ckb-retrieve` ground an answer without a round-trip to the
archive, and makes drift mechanically detectable.
2. `## Notes` — human-authored and protected everywhere. Closes a real
gap: `ckb-index-external` regenerates connector pages wholesale, so an
annotation written there was previously destroyed on the next refresh.
3. `source_fingerprint`/`source_checked` — a digest of the material a page
was built from. Freshness by date says a page has aged; a fingerprint
says whether its evidence moved. Most valuable for connector-backed
libs, where documents change with no notice.
4. `lint_report.py --quick` — a deterministic one-line session-start
signal, wired into Rule E next to the existing `git status` check.
5. In-degree as a rank-fusion signal in `ckb-retrieve`, weighted below 1.0:
centrality is a prior, not evidence.
6. Blast radius — a new `ckb-ingest` step walking the graph backwards from
touched entities to find what the incoming material contradicts, before
writing anything. Ingest was additive-first, which is how a wiki
accumulates two pages that quietly disagree.
7. Edge vocabulary in `wiki/graph/index.md` rewritten as a question per
verb, and completed: `part_of` was written by `ckb-code-map` but never
declared. Added `produces`, `configures`, `validates`, `implements`.
Lint gains checks 12 (fingerprint drift), 13 (crux verbatimness) and 14
(the protected-Notes rule), verified against a synthetic fixture covering
stale digests, missing sources, fabricated quotes and paraphrased evidence.
Not adopted: the gitignored regenerable store, the MCP server and CLI
daemon, tree-sitter parsing, statusline hooks, telemetry.
Co-Authored-By: Claude Opus 5 (1M context) <noreply@anthropic.com>
Commit all in-flight work — ckb-module and ckb-reset skills, the
.agents/modules/ scaffold, OPENSPEC docs, decision records D-0001 and
D-0002, graph edges and workload summaries — so the reset that follows
is fully recoverable.
Co-Authored-By: Claude Opus 5 (1M context) <noreply@anthropic.com>