lint

/lint — Wiki Health Check

LLM-wiki pattern: a periodic lint prevents entropy. Run weekly or after major ingest sessions.

Usage

/lint — full scan /lint orphans — just the floating-nodes check /lint stale — just stale entities /lint contradictions — just contradictions /lint drift — source drift check (content_hash validation)

Checks

1. Floating Nodes

A floating node is an entity with zero incoming links — invisible in the graph. Target: 0.

python3 -c "
import os, re
workspace=os.getcwd()
kg=os.path.join(workspace, 'knowledge')
# Directories to skip when scanning for links. Add any non-knowledge or build dirs here.
EXCLUDE = {'memory','archive','backups','agents','skills','content','data','node_modules','.venv','inbox'}
aliases = {}
for root,dirs,files in os.walk(kg):
    for f in files:
        if f.endswith('.md') and f not in ('AGENTS.md','INDEX.md'):
            name = f.replace('.md','')
            aliases[name] = name
            with open(os.path.join(root,f)) as fh:
                content = fh.read()
            if content.startswith('---'):
                try:
                    fm = content[3:content.index('---',3)]
                    m = re.search(r'aliases:\s*\[([^\]]+)\]', fm)
                    if m:
                        for a in m.group(1).split(','):
                            aliases[a.strip().strip('\"').strip(\"'\")] = name
                except: pass

entities = set(aliases.values())
incoming = {}
for root,dirs,files in os.walk(workspace):
    dirs[:] = [d for d in dirs if not d.startswith('.') and d not in EXCLUDE]
    for f in files:
        if not f.endswith('.md'): continue
        try:
            with open(os.path.join(root,f)) as fh:
                for link in re.findall(r'\[\[([^\]|]+)', fh.read()):
                    target = link.strip().split('/')[-1]
                    resolved = aliases.get(target, target)
                    incoming.setdefault(resolved, set()).add(f)
        except: pass

floating = sorted([n for n in entities if n not in incoming])
print(f'Floating: {len(floating)}')
for n in floating: print(f'  {n}')
"