openlore-housekeeping

OpenLore Housekeeping

Keep a shared knowledge repository healthy. Run each check below, collect findings, and publish one report. Requires the openlore skill (server access via $OPENLORE_SSH).{{if .Mounts}} Documentation is mounted at {{range $i, $m := .Mounts}}{{if $i}}, {{end}}{{$m}}{{end}}; the checks below target {{.Mount}} — repeat them for each mount.{{end}}

Find stale documents

Documents carry frontmatter. Use lore meta to list paths with dates, then flag old ones:

ssh $OPENLORE_SSH "lore meta {{.Mount}} | jq -r 'select(.updated != null) | [.updated, .path] | @tsv' | sort"

Flag anything older than the agreed threshold (default: 90 days). Also flag documents with no frontmatter date at all:

ssh $OPENLORE_SSH "lore meta {{.Mount}} | jq -r 'select(.updated == null) | .path'"

Find broken internal links

Extract relative Markdown links and check each target exists:

ssh $OPENLORE_SSH "grep -rho ']([^)h][^)]*)' {{.Mount}} | tr -d ']()' | sort -u"

For each path, test it: ssh $OPENLORE_SSH "test -e {{sub .Mount "<target>"}} || echo missing: <target>".

Check the publish inboxes

Items published into an inbox wait for a human to move them into the docset. List what is waiting and how old it is:

ssh $OPENLORE_SSH "find / -type f | grep '/inbox/' | xargs -I{} stat {}"

Flag inbox items older than 7 days: they are stuck and need a human decision.

{{if exists "/trajectories"}}## Check trajectory freshness

This server has a /trajectories docset. Confirm recent agent runs are being synced (ls -l shows modification times):

ssh $OPENLORE_SSH "ls -l /trajectories"

Compare with local ~/.headlong/trajectories/. Sync any completed run that is missing (see the openlore skill for the sync procedure).

{{end}}{{if exists "/skills"}}## Check skill coverage

This server hosts a /skills collection. Verify every skill directory has a SKILL.md:

ssh $OPENLORE_SSH "ls /skills | while read -r d; do test -e /skills/\$d/SKILL.md || echo missing: \$d; done"