@3030-labs/wotw 0.8.4

package/src/wiki/templates/CLAUDE.md

@@ -0,0 +1,87 @@
+# Watcher on the Wall — Wiki Schema
+
+You are the wiki-keeper. You maintain a structured knowledge base by processing
+source documents dropped into `raw/` and generating interlinked wiki pages in `wiki/`.
+
+## Directory Structure
+
+- `raw/` — Immutable source documents. You READ from here. You NEVER modify files here.
+- `wiki/` — Your wiki pages. You OWN this directory. You create, update, and maintain everything here.
+  - `wiki/index.md` — Master catalog of every page with one-line descriptions, organized by category
+  - `wiki/log.md` — Append-only chronological log of all operations
+  - `wiki/sources/` — Summary pages for individual source documents
+  - `wiki/concepts/` — Pages explaining technical concepts, methodologies, patterns
+  - `wiki/entities/` — Pages about people, companies, technologies, products
+  - `wiki/comparisons/` — Side-by-side analyses of alternatives
+  - `wiki/syntheses/` — Higher-order documents combining insights across sources
+  - `wiki/queries/` — Filed query results worth keeping
+- `CLAUDE.md` — This file. Your operating instructions. Read it at the start of every operation.
+
+## Page Format
+
+Every wiki page uses this format:
+
+```
+---
+title: "Page Title"
+category: "concept|entity|source|comparison|synthesis|query"
+created: "YYYY-MM-DD"
+updated: "YYYY-MM-DD"
+sources:
+  - "raw/filename.md"
+related:
+  - "wiki/concepts/related-page.md"
+tags: ["tag1", "tag2"]
+confidence: high|medium|low
+---
+```
+
+Followed by markdown content with cross-references using relative links.
+
+## Operations
+
+### INGEST (triggered by new files in raw/)
+
+1. Read the new source file(s)
+2. Create a summary page in `wiki/sources/`
+3. Create or update concept/entity pages as needed
+4. Add bidirectional cross-references to all related existing pages
+5. Update `wiki/index.md` with new entries
+6. Append operation to `wiki/log.md`
+
+### QUERY (triggered by query_wiki tool call)
+
+1. Read `wiki/index.md` to identify relevant pages
+2. Read the relevant pages
+3. Synthesize an answer
+4. If the answer combines insights from 3+ sources in a novel way, file it in `wiki/queries/` or `wiki/syntheses/`
+5. Update `wiki/index.md` if a new page was created
+
+### LINT (triggered by wotw lint or periodic maintenance)
+
+1. Scan all wiki pages for contradictions between pages
+2. Identify orphan pages (no inbound links)
+3. Identify stale pages (sources updated but wiki page not)
+4. Identify missing cross-references
+5. Fix what you can, flag what needs human review
+6. Append findings to `wiki/log.md`
+
+## Quality Standards
+
+- Every page must have at least 3 sentences of substantive content
+- Every page must link to at least one other wiki page
+- Every concept page must cite at least one source
+- No duplicate pages — if two pages cover the same topic, merge them
+- Use consistent terminology — define terms on first use, link to entity/concept pages
+- Confidence levels:
+  - `high` — multiple corroborating sources
+  - `medium` — single source
+  - `low` — inferred/synthesized
+
+## Non-negotiable rules
+
+1. NEVER write outside the `wiki/` directory.
+2. NEVER modify files in `raw/`.
+3. ALWAYS update `wiki/index.md` when you create or rename a page.
+4. ALWAYS append an entry to `wiki/log.md` describing the operation.
+5. NEVER delete a page without explicit instruction.

package/src/wiki/templates/getting-started.md

@@ -0,0 +1,89 @@
+---
+title: Getting Started
+category: concept
+created: __WOTW_UPDATED_ISO__
+updated: __WOTW_UPDATED_ISO__
+sources: []
+related: []
+tags:
+  - onboarding
+  - guide
+confidence: high
+---
+
+# Getting Started with Watcher on the Wall
+
+Welcome! This page will help you start building your knowledge base.
+
+## Quick Start
+
+1. **Drop files into `raw/`** — articles, papers, notes, PDFs, code, anything.
+2. **Run `wotw start`** — the Watcher begins watching `raw/` for changes.
+3. **Watch your wiki grow** — the Watcher automatically ingests files, extracts concepts, and creates interlinked pages.
+
+## How It Works
+
+The Watcher monitors your `raw/` directory for new and changed files. When it
+detects a change, it:
+
+1. Reads the source file(s)
+2. Sends them to an LLM for analysis
+3. Creates or updates wiki pages in the appropriate category
+4. Repairs cross-references between pages
+5. Rebuilds the search index
+6. Commits changes to git
+
+Every action is recorded in an append-only **provenance chain** so you can
+always trace where information came from.
+
+## Wiki Structure
+
+Your wiki is organized into six categories:
+
+| Category    | Directory           | What goes here                          |
+| ----------- | ------------------- | --------------------------------------- |
+| Concepts    | `wiki/concepts/`    | Ideas, frameworks, theories, patterns   |
+| Entities    | `wiki/entities/`    | People, organizations, products, tools  |
+| Sources     | `wiki/sources/`     | Summaries of ingested raw files         |
+| Comparisons | `wiki/comparisons/` | Side-by-side analyses of related topics |
+| Syntheses   | `wiki/syntheses/`   | Cross-cutting themes and insights       |
+| Queries     | `wiki/queries/`     | Answers to questions you've asked       |
+
+## Useful Commands
+
+| Command                 | Description                                     |
+| ----------------------- | ----------------------------------------------- |
+| `wotw start`            | Start the daemon (watches `raw/` for changes)   |
+| `wotw stop`             | Stop the daemon                                 |
+| `wotw status`           | Check daemon status, page counts, health        |
+| `wotw query "question"` | Ask a question (uses the running daemon)        |
+| `wotw search <terms>`   | Offline full-text search (no daemon needed)     |
+| `wotw lint`             | Check wiki health and find issues               |
+| `wotw lint --fix`       | Auto-heal common issues                         |
+| `wotw stale`            | Find pages that haven't been confirmed recently |
+| `wotw candidates`       | List pages awaiting approval                    |
+| `wotw approve <file>`   | Approve a candidate page into the wiki          |
+| `wotw reject <file>`    | Reject a candidate with optional feedback       |
+| `wotw audit`            | View the provenance chain                       |
+| `wotw logs`             | Tail the daemon log                             |
+
+## Tips
+
+- **Obsidian users**: This wiki is designed to work beautifully with
+  [Obsidian](https://obsidian.md). Cross-references use `[[wikilinks]]` and
+  the graph view shows how concepts connect.
+- **Search**: Use `wotw search` for quick offline lookups. Use `wotw query`
+  for deeper, LLM-powered answers.
+- **Provenance**: Every page has a footer showing its sources. Click through
+  to see exactly where information came from.
+- **Health**: Run `wotw lint` periodically to find stale pages, broken links,
+  and potential duplicates. Use `--fix` to auto-heal.
+
+## Next Steps
+
+1. Drop a few files into `raw/` and run `wotw start`
+2. Browse the generated pages in `wiki/`
+3. Try `wotw search` or `wotw query` to explore your knowledge
+4. Check `wotw status` for a health overview
+
+Happy knowledge building!

package/src/wiki/templates/index.md

@@ -0,0 +1,32 @@
+---
+title: Wiki Index
+updated: __WOTW_UPDATED_ISO__
+---
+
+# Wiki Index
+
+Welcome to your knowledge base. This index is automatically maintained by
+[watcher-on-the-wall](https://github.com/3030-Labs/watcher-on-the-wall).
+
+## Getting Started
+
+Drop source files (articles, papers, notes, code) into the `raw/` folder.
+The Watcher will automatically ingest them, extract key concepts, and build
+interlinked wiki pages here.
+
+## Categories
+
+- **[[concepts]]** — Ideas, frameworks, theories
+- **[[entities]]** — People, organizations, products, tools
+- **[[sources]]** — Summaries of ingested source material
+- **[[comparisons]]** — Side-by-side analyses
+- **[[syntheses]]** — Cross-cutting themes and insights
+- **[[queries]]** — Answers to questions asked of the wiki
+
+## Recent Activity
+
+<!-- wotw:index:start -->
+
+_No pages yet. Drop files into raw/ to get started._
+
+<!-- wotw:index:end -->

package/src/wiki/templates/log.md

@@ -0,0 +1,9 @@
+# Wiki Operations Log
+
+This file is an append-only log of every ingest, query, compound, and lint
+operation performed against this wiki. It is maintained automatically by
+watcher-on-the-wall.
+
+Entries are ordered oldest first.
+
+---