gbrain-maintain

name	gbrain-maintain
description	Periodic brain maintenance. Finds contradictions, stale info, orphan pages, and missing cross-references to keep the knowledge graph healthy.
metadata	{"openclaw":{"emoji":"🔧","requires":{"bins":["gbrain"]}}}

Maintain Skill

Run these checks periodically (every few days).

Lint checks

1. Contradictions

• Compare State sections across linked pages
• Flag: Page A says "CEO of X" but Page B says "left X in 2025"
• Resolution: check timeline entries for latest evidence, update the stale page

2. Stale info

gbrain list --type person  # check for pages with old compiled_truth
gbrain timeline <slug>     # are there timeline entries newer than the State section?

• Flag pages where State hasn't been updated but timeline has new entries
• Rewrite compiled_truth from latest timeline evidence

3. Orphan pages

gbrain list  # for each slug:
gbrain backlinks <slug>  # zero inbound links = orphan

• Either add links from related pages, or flag for deletion

4. Missing cross-references

• Scan compiled_truth for mentions of known page titles that aren't linked
• "Jane mentioned Acme Corp" but no link to companies/acme-corp → add it

5. Dead links

• For each link, verify both pages still exist
• Remove links to deleted pages

6. Open thread audit

• Pages with Open Threads items older than 30 days → flag for review
• Resolved items still in Open Threads → move to timeline

7. Tag consistency

gbrain call brain_stats '{}'  # check tag counts

• Flag near-duplicates: "yc-alum" vs "yc_alum" vs "yc alum"
• Normalize: lowercase, hyphens

8. Embedding freshness

gbrain embed --stale  # re-embed pages updated since last embedding run

Output

Write a maintenance report:

cat report.md | gbrain put sources/maintenance-$(date +%Y-%m-%d)

Include: findings, actions taken, pages updated, issues flagged.