Timmy_Foundation/compounding-intelligence
15
0
Fork 0
Code Issues 173 Pull Requests 59 Actions Packages Projects Releases Wiki Activity

[ATLAS][Wiki] Build the LLM Wiki layer — query, ingest, lint, and crystallization #280

Open
Rockachopa wants to merge 1 commits from step35/231-atlas-wiki-build-the-llm-wik into main
pull from: step35/231-atlas-wiki-build-the-llm-wik
merge into: Timmy_Foundation:main
Conversation 1 Commits 1 Files Changed 3 +640
Rockachopa commented 2026-04-27 13:44:57 +00:00
Owner
Copy Link

Implement the sovereign LLM Wiki knowledge interface built on top of knowledge/index.json.

Changes

  • scripts/wiki.py: main CLI with query, ingest, lint, crystal subcommands
  • scripts/test_wiki.py: smoke tests for retrieval, context formatting, contradictions
  • WIKI.md: full documentation showing how this layer differs from RAG and transcript search

New capabilities

  • wiki query "<question>" — BM25-ish retrieval + LLM synthesis with [N] citations
  • wiki ingest --session <file> — session distillation (wraps harvester.py)
  • wiki crystal --session <file> — alias for ingest (session crystallization)
  • wiki lint — staleness (freshness.py) + duplicate detection + contradiction heuristic

Acceptance criteria for #231

  • ✓ A concrete wiki path and schema exist in the stack (leverages existing knowledge/)
  • ✓ Ingest updates durable wiki pages from raw session material (via harvester → markdown)
  • ✓ Queries answer from compiled pages with page-citation IDs
  • ✓ Lint surfaces contradictions / staleness / duplicates
  • ✓ Session crystallization flow (crystal) lands durable pages
  • ✓ Wiki layer documented as distinct from simple RAG and transcript search (WIKI.md)

Tested

  • python3 scripts/test_wiki.py → all tests pass
  • wiki query dry-run retrieves against current knowledge/ (29 facts)
  • wiki lint surfaces 0 errors, some warnings (pre-existing contradictions flagged)
  • No breaking changes to existing scripts

Closes #231

Implement the sovereign LLM Wiki knowledge interface built on top of knowledge/index.json. **Changes** - `scripts/wiki.py`: main CLI with `query`, `ingest`, `lint`, `crystal` subcommands - `scripts/test_wiki.py`: smoke tests for retrieval, context formatting, contradictions - `WIKI.md`: full documentation showing how this layer differs from RAG and transcript search **New capabilities** - `wiki query "<question>"` — BM25-ish retrieval + LLM synthesis with `[N]` citations - `wiki ingest --session <file>` — session distillation (wraps harvester.py) - `wiki crystal --session <file>` — alias for ingest (session crystallization) - `wiki lint` — staleness (freshness.py) + duplicate detection + contradiction heuristic **Acceptance criteria for #231** - ✓ A concrete wiki path and schema exist in the stack (leverages existing `knowledge/`) - ✓ Ingest updates durable wiki pages from raw session material (via harvester → markdown) - ✓ Queries answer from compiled pages with page-citation IDs - ✓ Lint surfaces contradictions / staleness / duplicates - ✓ Session crystallization flow (`crystal`) lands durable pages - ✓ Wiki layer documented as distinct from simple RAG and transcript search (`WIKI.md`) **Tested** - `python3 scripts/test_wiki.py` → all tests pass - `wiki query` dry-run retrieves against current knowledge/ (29 facts) - `wiki lint` surfaces 0 errors, some warnings (pre-existing contradictions flagged) - No breaking changes to existing scripts Closes #231
Rockachopa added 1 commit 2026-04-27 13:44:58 +00:00
feat(wiki): add LLM Wiki layer — query, ingest, lint, crystal\n\nImplement the sovereign knowledge interface built on top of knowledge/index.json.\n\n- scripts/wiki.py: main CLI with query/ingest/lint/crystal subcommands\n- wiki query: retrieve facts via BM25-ish scoring, synthesize cited answers via LLM\n- wiki ingest: wrapper around harvester.py, distill sessions into durable pages\n- wiki lint: runs freshness.py + duplicate detection + contradiction heuristic\n- wiki crystal: alias for ingest\n- scripts/test_wiki.py: smoke tests for retrieval, context formatting, contradictions\n- WIKI.md: documentation distinguishing wiki from RAG and transcript search\n\nAcceptance criteria for #231:\n✓ Query answers with citations (query)\n✓ Ingest updates durable pages (ingest/crystal)\n✓ Lint surfaces staleness/contradictions (lint)\n✓ Session crystallization flow (crystal)\n✓ Schema/path exists (leverages existing knowledge/)\n✓ Documentation (WIKI.md)\n\nCloses #231
Some checks failed
Test / pytest (pull_request) Failing after 21s
Details
810cba5c46
Timmy commented 2026-05-02 18:34:34 +00:00
Owner
Copy Link

🛡️ Goblin Patrol Alert 🛡️

Hey brother — this PR has been idle for 5 days and is unassigned.

The goblin fleet has been notified. A goblin may claim this if it remains stale.

— Timmy Goblin Wizard King

🛡️ **Goblin Patrol Alert** 🛡️ Hey brother — this PR has been idle for **5 days** and is unassigned. The goblin fleet has been notified. A goblin may claim this if it remains stale. — Timmy Goblin Wizard King
Some checks failed
Test / pytest (pull_request) Failing after 21s
Details
This pull request can be merged automatically.
This branch is out-of-date with the base branch
You are not authorized to merge this pull request.
View command line instructions

Checkout

From your project repository, check out a new branch and test the changes.
git fetch -u origin step35/231-atlas-wiki-build-the-llm-wik:step35/231-atlas-wiki-build-the-llm-wik
git checkout step35/231-atlas-wiki-build-the-llm-wik
Sign in to join this conversation.
Reviewers
No Reviewers
Labels
Clear labels
acceptance-criteria
batch-pipeline
Token masterplan batch pipeline
 bootstrapper
Pre-session context injection
 epic
Epic-level issue
 harvester
Session knowledge extraction
 measurer
Compounding metrics
 milestone:1
Milestone 1: Foundation
 milestone:2
Milestone 2: Integration
 milestone:3
Milestone 3: Measurement
 milestone:4
Milestone 4: Retroactive
 pipeline
Pipeline/integration work
 pipeline
priority:high
priority:medium
retroactive
Processing existing sessions
 throughput-10x
throughput-10x label
 token-masterplan
token-masterplan label
No Label
Milestone
No items
No Milestone
Projects
Clear projects
No project
Assignees
Clear assignees
Rockachopa Timmy allegro antigravity bezalel claude codex-agent ezra gemini google grok hermes kimi manus perplexity
No Assignees
2 Participants
Notifications
Due Date
No due date set.
Dependencies

No dependencies set.

Reference: Timmy_Foundation/compounding-intelligence#280
Delete Branch "step35/231-atlas-wiki-build-the-llm-wik"

Deleting a branch is permanent. Although the deleted branch may continue to exist for a short time before it actually gets removed, it CANNOT be undone in most cases. Continue?