Initial wiki structure: SCHEMA.md, index.md, log.md (personal KB, profile: wiki, repo: personal-wiki, shared with floof)

This commit is contained in:
Hermes Agent (wiki profile)
2026-09-18 11:32:59 +01:00
commit f83351c0ab
4 changed files with 118 additions and 0 deletions
+63
View File
@@ -0,0 +1,63 @@
# Wiki Schema (Personal KB — hermes/personal-wiki on gitea.maukit.com)
## Domain
Personal LLM / AI knowledge base maintained via isolated Hermes `wiki` profile.
Repo: `https://gitea.maukit.com/hermes/personal-wiki` (shared with floof for push access).
Local root: `/opt/data/wiki` (cloned git repo).
Agent profile: `/opt/data/profiles/wiki/` (isolated — only writes via this profile).
## Conventions
- File names: lowercase, hyphens, no spaces
- Every page starts with YAML frontmatter (title, created, updated, type, tags, sources, confidence, contested)
- Use `[[wikilinks]]` for internal links (min 2 outbound per page)
- Raw sources (`raw/`) are immutable; corrections go in wiki pages
- Every ingest/update must append to `log.md`
- Every new page must be added to `index.md`
- Use `#` for headers, `---` for YAML delimiters
- Only tags from the taxonomy below
## Tag Taxonomy
- kb: kb, source, reference, note, summary
- domain: personal, workflow, homelab, ai, model, tool, skill, script
- meta: comparison, timeline, open-question, confirmed, contested
- layer: raw, entity, concept, comparison, query
## Page Thresholds
- Create page: entity/concept in 2+ sources OR central to 1 source
- Don't create for passing mentions or single-source footnotes
- Update: add new info, bump `updated`, note contradictions
- Split page when >200 lines
- Archive superseded content to `_archive/`
## Frontmatter Template
```yaml
---
title: Page Title
created: YYYY-MM-DD
updated: YYYY-MM-DD
type: entity | concept | comparison | query | summary
tags: [kb, domain-tag, meta-tag]
sources: [raw/articles/file.md]
confidence: high | medium | low
contested: true | false
contradictions: [other-page-slug]
---
```
## Update Policy
- Newer sources supersede older
- Contradictions: note both claims with dates, mark `contested: true`, list in `contradictions`
- Always bump `updated` when editing
- Every edit must update `log.md`
## Quality Signals
- `confidence: high` → multi-source, well-corroborated
- `confidence: medium` → single source or partial corroboration
- `confidence: low` → speculative / opinion-heavy / contested
- `contested: true` → page has unresolved contradictions (must be resolved before promoting to `high`)
## Source Drift Check
Raw files have `sha256:` (body hash, not frontmatter). Re-ingest must compare hash; skip if identical, update if different.
## Access & Sharing
Repo shared with `floof` (push access, Gitea user id 3). Other agents / hosts read via git clone (public repo); only `wiki` profile writes. Second Telegram bot deferred.
+8
View File
@@ -0,0 +1,8 @@
# Wiki project (verified 2026-09-18)
Profile: /opt/data/profiles/wiki/ (isolated agent, WIKI_PATH=/opt/data/wiki)
Repo: https://gitea.maukit.com/hermes/personal-wiki (public, id 153)
Shared with floof (Gitea user id 3, push verified via API)
Skill: llm-wiki (Karpathy) patched for /opt/data/wiki root; cloned to repo root
Files: SCHEMA.md / index.md / log.md in /opt/data/wiki/
Second bot: deferred (user will revisit)
Memory budget exceeded — don't duplicate full notes here; key facts in session context.
+30
View File
@@ -0,0 +1,30 @@
# Wiki Index
> Content catalog for personal-wiki (`https://gitea.maukit.com/hermes/personal-wiki`).
> Local root: `/opt/data/wiki`. Profile: `~/profiles/wiki/` (isolated Hermes agent).
> Shared with `floof` (Gitea push access). Read access: public repo clone.
> Last updated: 2026-09-18 | Total pages: 0 (new wiki — populated by `wiki` profile agent)
## Raw Sources (`raw/`)
- `raw/articles/` — web clippings, saved articles
- `raw/papers/` — PDFs, papers
- `raw/transcripts/` — meeting notes, interviews
- `raw/assets/` — images / diagrams
## Layer 2 — Wiki Pages
### Entities (notable people, orgs, products, models, hosts, services)
<!-- Alphabetical; add new pages here with one-line summary -->
### Concepts (topics, techniques, patterns, categories)
<!-- Alphabetical; every page must have 2+ `[[wikilinks]]` -->
### Comparisons (side-by-side analyses)
<!-- Add with dimensions + verdict -->
### Queries (filed synthesis / answers worth keeping)
<!-- Only substantial answers; trivial lookups don't need a page -->
---
*Scale rules: >50 entries per section → split by sub-topic / letter. >200 total entries → add `_meta/topic-map.md`.*
+17
View File
@@ -0,0 +1,17 @@
# Wiki Log
> Chronological, append-only record of all wiki actions.
> Format: `## [YYYY-MM-DD] action | subject`
> Actions: create, ingest, update, query, lint, archive, delete
> Rotate when >500 entries: rename to `log-YYYY.md`, start fresh.
## [2026-09-18] create | Wiki initialized
- Domain: personal LLM / AI knowledge base
- Repo: `https://gitea.maukit.com/hermes/personal-wiki` (public, shared with floof for push)
- Local root: `/opt/data/wiki` (cloned empty repo)
- Profile: `/opt/data/profiles/wiki/` (isolated Hermes agent — only profile writing)
- Skill: `llm-wiki` (`/opt/data/skills/research/llm-wiki/`) — patched to use `/opt/data/wiki` as `WIKI_PATH`
- Schema, index, log initialized
- Raw directories (`raw/articles/`, `raw/papers/`, `raw/transcripts/`, `raw/assets/`) created
- Second Telegram bot deferred; will revisit if needed
- Gitea access verified: user `hermes` (id 148), user `floof` (id 3) has push access