28 Commits

Author SHA1 Message Date
Yuhan Lei eafcc77001 fix: align log inventory and examples 2026-07-24 00:57:31 +08:00
Yuhan Lei 36b1eb7ee0 fix: close typed evidence candidate matching 2026-07-24 00:56:30 +08:00
Yuhan Lei 2e88ef6a52 fix: centralize fence-aware document structure 2026-07-24 00:51:59 +08:00
Yuhan Lei 9340c1f581 fix: close the candidate set and hold examples to it
Tokenizer rewritten in closed form (strict thousands grouping, dotted
tokens as a whole) and frozen: quotes, ISO dates, and specific number
forms are the documented candidate set; new prose forms extend the
docstring, not the regexes. Quote pairing no longer skips short pairs
into phantom quotes. Raw links parse only from the fenced-stripped
header. Skip-files applies only to root-level index/log. Body
blockquotes join the quote channel. Fence openers are indent-limited.

Examples now honor their own invariant: two fabricated quotes restored
to the raw wording, the market-data date moved into the raw body, and
the index example rewritten as a real global-index excerpt. A smoke
test assembles the examples and demands zero suspects, so the samples
stay under their own contract. Archive pages get a defined index date
(their Archived field) for lint cross-checks.
2026-07-24 00:10:13 +08:00
Yuhan Lei ad9a5a786f fix: close contract gaps between skill, templates, and examples
- The invariant now states honestly that the script checks the
  high-signal literal subset; compile-time locate-before-write covers
  the rest.
- See Also links get a single authority: internal-links rules no
  longer cover them, and their own rule handles rename-fix, removal,
  and ambiguity reporting.
- Malformed Status judgment matches the template: only Outdated
  requires a date.
- Articles gain a required Updated metadata field, closing the loop
  with cascade rules that refresh it and giving lint a mechanical
  cross-check for index Updated dates (new auto-fix rule).
- Examples align with current schemas: Sources plural, Published in
  raw, Updated in article and index.
2026-07-23 23:18:33 +08:00
Yuhan Lei e3b7c68fee fix: close verification escapes and false-suspect sources
- Sentence-final punctuation in the raw no longer blocks matching;
  the boundary only rejects continuations that form a different value.
  This was a regression from the boundary fix itself and would have
  flooded reports with verbatim facts.
- Raw links must resolve inside raw/; anything else is an evidence
  error, since the invariant's permanence rests on raw immutability.
- No-material suppression is anchored to ingest entry headings, so
  prose mentions elsewhere in the log cannot hide backlog.
- Metadata semantics are scoped to the header block after the H1:
  an Archived line in the body no longer grants exemption, and
  metadata-shaped lines in a raw file's body stay evidence.
- Status blocks are skipped wholesale, including their explanation
  lines, which legitimately cite newer sources outside the article's
  own Raw links.
- Fence stripping handles tilde and 3+-backtick fences via a state
  machine; candidate tokens are whitespace-normalized before dedup;
  index/log args are skipped even when passed explicitly; articles
  are checked once, not twice.
2026-07-23 23:15:06 +08:00
Yuhan Lei f8e592f979 docs: bring examples and install instructions up to current protocol
log-sample.md now shows the real entry types (ingest with Disposition
and Raw, no-material with full path, archived query, lint) instead of
the retired Compile/Update vocabulary that referenced directories this
skill does not use. Manual install instructions include scripts/ so
the evidence checker actually ships.
2026-07-23 22:47:45 +08:00
Yuhan Lei 19b342b981 fix: align skill contract with the checker
- No-material log entries record the full raw path and the script
  matches on it, so same-named files elsewhere are no longer wrongly
  exempted from the backlog report.
- The invariant drops incremental lint state: the script re-checks the
  whole wiki in seconds, which also removes the touched-set
  reconstruction problem and the vanishing-unresolved-suspect hole.
- Status block checks move to Judgment Reports; nothing consumes them
  mechanically yet, so a mechanical sweep would guard a hypothetical.
- Research is gated to explicit research/ingest requests, resolving
  the routing contradiction with read-only Query.
- Mechanical Reports invoke the script via python3 (works without an
  exec bit) and name the argument <project-root>.
2026-07-23 22:46:09 +08:00
Yuhan Lei 3556cf45fa fix: make the evidence checker actually check
- Boundary matching: '42K' no longer passes against '142K' in the raw,
  closing the substring false-pass on the exact transcription-error
  class the checker exists for.
- Coverage: decimals and 4+ digit numbers (incl. bare years) are now
  candidates; small plain integers stay out of scope by design and the
  boundary is documented in the docstring.
- Fenced code is stripped before extraction (line-by-line processing
  made the multiline regex useless), and Status/Archived metadata
  lines no longer produce marker-date false suspects.
- Raw files are matched without their collection-metadata header, so a
  Collected date cannot false-pass an article's claim about that year.
- Evidence errors are reported instead of silently passing: ordinary
  articles without a Raw field, and Raw links that do not resolve.
- Article path arguments resolve against the project root, and missing
  files are warnings, not tracebacks.
2026-07-23 22:44:11 +08:00
Yuhan Lei ed7327fa6a docs: add design boundaries section to README
Public record of what was deliberately not built and why (source
hashes, persisted line anchors, numeric confidence, review dates,
decay, retract machinery, hooks, vector/graph search, typed relations,
OKF, MCP/UIs), grounded in production logs and ecosystem research.
2026-07-23 22:14:27 +08:00
Yuhan Lei dcc4ec415f feat: guard against false absence and add research discipline
Query may only claim the wiki lacks relevant content after both the
index and a synonym-aware full-text search come back empty. Research
(multi-source ingest) gets a minimal section: wide-net search with
synonyms, opposing-evidence search for core claims, parallel search
allowed but strictly sequential compilation because index/log/cascades
are shared state.
2026-07-23 22:10:31 +08:00
Yuhan Lei aa4d3597cc feat: add status blocks and full-wiki cascade search
Superseded and disputed claims now get fixed-format Status blocks
(Outdated / Disputed) instead of freeform prose notes, so readers and
lint can recognize them mechanically. Cascade updates no longer scan
only the same topic directory and index entries; they grep the full
wiki for the source's entities, aliases, and affected claims, which is
where outdated claims used to hide until a human tripped over them.
2026-07-23 22:09:47 +08:00
Yuhan Lei 959bbb3858 feat: add grounding invariant with mechanical evidence checker
Every load-bearing fact (number, date, direct quote) must exist
verbatim in the raw files an article links. Compile establishes the
invariant (locate before write, exact literals, derived values show
components); lint verifies it with scripts/check_evidence.py, which
greps candidate literals against linked raws and reports misses plus
unreferenced raw files. Lint is now three tiers: safe auto-fixes,
mechanical reports (the script), judgment reports. Also moves adding
See Also cross-references out of auto-fix, where judgment never
belonged.
2026-07-23 22:08:36 +08:00
Yuhan Lei 01898a68fd feat: add ingest disposition triage with no-material stop path
Replace the unconditional fetch+compile rule with a disposition
(New / Update / Disputed / No material) stated after a wiki search.
No-material sources stay in raw/ and are logged with their disposition,
so thin sources no longer get forced into articles and lint can later
tell disposed stock from genuinely unreferenced raw files.
2026-07-23 22:01:44 +08:00
Yuhan Lei 9e8c4f44ce docs: streamline README for readability while preserving SEO structure 2026-04-13 09:37:27 +08:00
Yuhan Lei 7566892f32 docs: improve github seo copy 2026-04-13 01:01:21 +08:00
Yuhan Lei 637eccaa15 docs: translate example files from Chinese to English
- Translate 2026-03-19-claude-code-statusline-landscape.md (148 lines)
- Fix mixed Chinese/English in claude-code-statusline-landscape.md (Impact section)
- All example files now uniformly in English
2026-04-13 00:54:31 +08:00
Yuhan Lei 76eafef9b1 docs: add GEO optimization for AI citation
- Add FAQ section (6 Q&As covering key concepts)
- Add Key Takeaways summary box
- Add definition statements (This skill is..., Agent Skills is..., LLM Wiki is...)
- Add precise citation format (April 4, 2026, 2,100+ stars)
- Reduce keyword density from 3.8% to 0.9%
- Increase total word count from 551 to 885 (+60%)
- GEO score: 53 → 70+ estimated
2026-04-13 00:47:44 +08:00
Yuhan Lei 7f2e2ae64a docs: optimize README for SEO and discoverability
- Add social badges (stars, forks, install)
- Update subtitle to highlight tool compatibility
- Optimize H2 headers with keywords
- Add links to SKILL.md and SPEC.md
- Add OpenCode compatibility and alternative implementations
- Repository topics updated (7→15, +karpathy, llm-wiki, mcp, rag, etc)
- Description updated with battle-tested metrics
2026-04-13 00:12:57 +08:00
Yuhan Lei 6b94cc1bab chore: exclude PROMOTION.md from tracking (internal log) 2026-04-12 21:24:50 +08:00
Yuhan Lei 2d37566c9e docs: compress PROMOTION.md (256→97 lines, 62% reduction)
- Replace Coverage summary with Waves Summary table
- Remove Wave 7 prep drafts (dup with AWESOME_SUBMISSIONS.md)
- Update Notes (docs/ no longer excluded)
- Archive Wave 1-8 details below summary table
- Update snapshot: 247 stars, 34 forks
2026-04-12 21:23:38 +08:00
Yuhan Lei b67de7e822 docs: add promotion log to root directory
- Move from docs/ (excluded) to root for public visibility
- Track 8 waves of promotion activity across Reddit/X/Linux.do/GitHub
- Current: 247 stars, 34 forks, PR #216 open
2026-04-12 21:18:25 +08:00
Yuhan Lei d8afa65f3e docs: showcase real wiki data (94 articles, 99 sources, 87 log entries)
- Add Battle-Tested section with growth metrics
- Add examples/ directory with real articles and operation log
- Update from 48→94 articles, 8→13 topics
- Prove active maintenance with 87 entries in last 7 days
2026-04-12 21:14:15 +08:00
Yuhan Lei 5a3acdc2cf docs: add Karpathy tweet screenshot to README 2026-04-05 14:27:20 +08:00
Yuhan Lei 8a5d6a54eb fix: correct Karpathy gist URL in README 2026-04-05 14:23:57 +08:00
Yuhan Lei 76631bb7d3 docs: add README and MIT license
Effect-first README: install command, 3-step quick start,
architecture overview, compatibility table. Links to Karpathy's
original idea file gist.
2026-04-05 14:17:01 +08:00
Yuhan Lei 85d6275ad7 feat: add SKILL.md and reference templates
Implement the karpathy-llm-wiki skill following agentskills.io open
standard. Three operations: Ingest (fetch + compile), Query (search +
archive), Lint (deterministic auto-fix + heuristic reports). Passed
5 rounds of dual-model crosscheck review.
2026-04-05 14:13:58 +08:00
Yuhan Lei d8f3d00f96 chore: init repo with spec and reference docs
- docs/SPEC.md: 产品设计 spec(五轮 crosscheck 定稿)
- docs/karpathy-idea-file-reference.md: Karpathy 原始 gist 内容(实施参考)
2026-04-05 13:37:06 +08:00