v1.24.0 — Decision Log, Principles, Axioms & Local Git Safety Net

Decisions, Principles & Axioms

A new knowledge layer in 03-Resources/, built for how AI agents actually reason — not just search:

• Decisions/ — log hard-to-reverse choices with a mandatory Alternatives Rejected section. This is the single most valuable part: it stops an agent from re-proposing an idea you already considered and rejected months ago.
• Principles/ — standing behavioral rules distilled from repeated decisions ('we always do X', not just 'we chose X on this date').
• Axioms.md — the small set of foundational beliefs everything else derives from. Ships empty on purpose — these should be yours, not generic filler.

All three link into 03-Resources/README.md and reference each other (derived_from, evidenced_by frontmatter fields) so an agent can traverse why a rule exists, not just that it exists.

Local Git Safety Net

New _System/Scripts/session_git_snapshot.py:

• Auto-commits a snapshot of the vault at session end — local history only, never pushes or fetches
• Secret-scanning gate: refuses to commit if it detects anything that looks like an API key (OpenAI/Anthropic/GitHub/AWS/Slack patterns), a generic password=/token=, or a private key block — logs only the file path (never the content) to cron-errors.log
• Auto-initializes a local repo if none exists; never touches an existing repo's remote config
• Logs every run to 04-Archives/Cron/git-snapshot.log

Wire it in as a Hermes hook on on_session_end for a cheap undo button against bad multi-file agent edits.

---

Full Changelog: v1.23.1...v1.24.0

v1.23.1 — Fix: cron sessions were still leaking into Daily/

🐛 Fix

Closes #10.

v1.23.0 ("separate cron metadata from session content") only moved the cron lock file and logs into 04-Archives/Cron/. The cron-run session notes themselves (cron_<jobid>_<timestamp>-<slug>.md) kept landing in 04-Archives/Daily/, mixed in with real chat sessions — one real vault had 749 of these files inflating Dataview queries and vault_audit.py's orphan count.

What changed

• hermes_session_sync.py now routes cron-run session notes to 04-Archives/Cron/sessions/YYYY/MM/DD/ instead of Daily/, going forward
• Wrapped os.path.getmtime() in a new _safe_getmtime() helper to tolerate a FileNotFoundError race condition on OneDrive-synced vaults (reported in the issue)
• vault_audit.py no longer counts dated session notes as orphaned files — nothing is expected to wikilink into an individual session note
• New migrate_cron_sessions.py — one-off migration for anyone upgrading from v1.23.0: moves existing cron_*.md files out of Daily/ into Cron/sessions/ and updates manifest.jsonl paths. Safe to re-run.

Upgrading from v1.23.0?

python _System/Scripts/migrate_cron_sessions.py --vault "<vault-path>" --verbose

New installs on v1.23.1+ never need this — it's handled automatically going forward.

Verified against a real vault

749 affected cron files found and migrated, 0 left in Daily/ afterward, manifest.jsonl paths updated for all of them, real chat sessions (197 of them) untouched.

---

Full Changelog: v1.23.0...v1.23.1

v1.23.0 — Cron Separation, Install Verification & Feature Packs

🆕 What's New

Separated cron metadata from session content

Cron lock files and run logs no longer mix with your daily session notes. Everything operational now lives in 04-Archives/Cron/:

• cron-runs.log — timestamped history of every hourly archive run (status, duration, sessions processed, tokens)
• cron-errors.log — full tracebacks when a cron run fails
• Lock file moved out of Daily/ so your knowledge timeline stays clean

Post-install verification

install.sh/install.ps1 now run verify_install automatically after setup, checking:

• Vault folder structure (01-Projects → 04-Archives)
• Required Obsidian plugins (dataview, kanban, obsidian-local-rest-api)
• MCP server status
• Memory promotion pipeline
• User-Profile.md integrity

Opt-in feature packs

New _System/Scripts/features/ directory lets you grow into the template instead of being overwhelmed on day one:

• beginner/ — core archiving + memory promotion (default)
• analyst/ — semantic search, session tagging, performance dashboards
• poweruser/ — skill forecasting, vault audit, template drift checker
• experimental/ — bleeding-edge integrations

Template drift checker

New template_drift.py compares your vault against the latest template release via SHA256 hashing, classifying every file as safe-to-update, customized (preserve), outdated, or missing — so template upgrades never clobber your personal work.

Plugin cleanup

Removed smart-connections and brain-atlas from the default community plugin set.

Also included

• generate_changelog.py fix for breaking-change (!) commit markers and the 'Other Changes' changelog section, plus CI lint coverage
• README.md improvements: 60-second quickstart, outcomes table, trust/verification checklist (from the previous release)
• promote_memory.py --review interactive mode (from the previous release)

---

Full Changelog: v1.22.22...v1.23.0

Hermes Brain Template v1.22.22

What's New

🧠 Memory Promotion Enhancement

• Added --review interactive mode to promote_memory.py
  • Lists all pending memory candidates with numbers
  • Select a candidate to review full note content
  • Choose action: [h]ermes MEMORY.md, [p]rofile, [d]ismiss, [s]kip, [q]uit
  • Properly moves processed files to Reviewed/ subfolder
  • Updates Consolidation-Log.md audit trail

Includes All Previous Features

• MCP Server (v1.22.20)
• Graph View Enhancements (v1.22.19)
• About Me Page with your details (v1.22.16)
• Installer Preservation Fix (v1.22.10)
• CI Lint Fixes (v1.22.11)
• Capabilities Reference (v1.22.12)

📦 What’s Inside

• Core vault structure: 01-Projects/, 02-Areas/, 03-Resources/, 04-Archives/
• Standard plugins: Kanban, Dataview, Smart Connections, obsidian-local-rest-api
• Comprehensive script library (_System/Scripts/): vault audit, agent performance, MCP server, memory promotion, etc.
• Templates: ADRs, Daily Reviews, Lessons Learned, Personality Judgment, Projects, Research Notes
• Installers: install.sh (bash) & install.ps1 (PowerShell)
• Security: Personal-data-guard CI job (prevents accidental secret leaks)
• Sample data generator (seed_sample_data.py) — opt-in only, output never committed

🔗 Get It

👉 GitHub Repo: https://github.com/mistrysiddh/hermes-brain-template
👉 Direct Release: https://github.com/mistrysiddh/hermes-brain-template/releases/tag/v1.22.22
👉 Docs Site: https://mistrysiddh.github.io/hermes-brain-template/ (GitHub Pages)

💡 Pro Tip

If you’re updating an existing vault, the installer will skip overwriting your 02-Areas/User-Profile.md if it already has content — your personal profile stays safe.

Hermes Brain Template v1.22.13

What's Changed

📄 New Documentation

• Added page for users to share personal/professional details

🔧 Includes All Previous Fixes

• Installer preservation fix (v1.22.10): Both and now preserve existing files during template installation/update
• CI lint fixes (v1.22.11): Fixed and to write reports to the resolved vault path
• Capabilities reference (v1.22.12): Added documenting built-in skills and learned workflows

📦 Version

• Template version: 1.22.13 (see VERSION file)

Full Changelog

v1.22.12...v1.22.13

Hermes Brain Template v1.22.16

What's Changed

👤 About Me Page

• Added Siddh Mistry's personal and technical details to

🔧 Includes All Previous Fixes

• Installer preservation fix (v1.22.10): Both and now preserve existing files during template installation/update
• CI lint fixes (v1.22.11): Fixed and to write reports to the resolved vault path
• Capabilities reference (v1.22.12): Added documenting built-in skills and learned workflows
• About-me page template (v1.22.13): Added template for users to fill in their details

📦 Version

• Template version: 1.22.16 (see VERSION file)

Full Changelog

v1.22.15...v1.22.16

Hermes Brain Template v1.22.14

What's Changed

📄 New Documentation

• Added page for users to share personal/professional details

🔧 Includes All Previous Fixes

• Installer preservation fix (v1.22.10): Both and now preserve existing files during template installation/update
• CI lint fixes (v1.22.11): Fixed and to write reports to the resolved vault path
• Capabilities reference (v1.22.12): Added documenting built-in skills and learned workflows

📦 Version

• Template version: 1.22.14 (see VERSION file)

Full Changelog

v1.22.13...v1.22.14

Hermes Brain Template v1.22.11

What's Changed

🔧 Bug Fixes & Improvements

• Installer preservation fix (v1.22.10): Both and now preserve existing files during template installation/update — prevents overwriting user's filled-out profile with blank template
• CI lint fixes (v1.22.9): Fixed and to write reports to the resolved vault path instead of falling back to workspace location; updated workflow test assertions

📚 Documentation

• Jekyll documentation site with just-the-docs theme (, , , , , )
• GitHub Actions workflow () for reliable Jekyll builds
• Just-the-docs theme configuration with Gemfile
• Nemoclaw (NVIDIA-inspired dark theme) as default, Tokyo Night as alternative, light-mode variant added

🏗️ Template Structure

• Core vault areas: , , ,
• Standard plugin set: Kanban, Dataview, Smart Connections, obsidian-local-rest-api
• Comprehensive script library in (vault audit, agent performance, semantic search, session tagging, skill forecast, etc.)
• Templates for: Architecture Decision Records, Daily Reviews, Lessons Learned, Personality Judgment, Projects, Research Notes
• Installers for bash () and PowerShell ()

🔒 Security

• Personal data guard CI job (No disallowed personal-content paths found.) — prevents accidental commits of secrets/API keys
• Sample data generator script () — opt-in only, output never committed

📦 Version

• Template version: 1.22.11 (see VERSION file)

Full Changelog

v1.22.10...v1.22.11

Hermes Brain Template v1.22.9

What's Changed

• Fixed CI lint workflow: vault_audit.py and agent_performance.py now write reports to the resolved vault path instead of falling back to workspace location
• Bumped version to 1.22.9

Full Changelog

v1.22.8...v1.22.9

Release v1.22.8: Documentation & Installer Polish

Release v1.22.8 - Documentation & Installer Polish

What's Updated

• README.md — Improved structure, clarified installation paths, updated badges, and added clearer onboarding flow
• INSTALL_PROMPT.md — Refined the paste-into-Hermes prompts for better reliability
• SETUP.md — Updated cross-platform paths, installer references, and configuration steps
• Installer scripts ( / ) — Unified path handling for the PARA structure, fixed edge cases
• Core automation scripts — , , , , etc. updated for consistency
• Daily-Review template — Minor improvements for daily review workflow

Why This Matters

• ✅ Cleaner onboarding — New users hit fewer friction points
• ✅ Path consistency — All scripts correctly reference and PARA folders
• ✅ Documentation accuracy — Docs match the actual vault structure
• ✅ Installer reliability — Edge cases handled in install/uninstall/update flows

Template Status

• ✅ All framework components intact (Personality Judgment, dashboard, canvas)
• ✅ Zero personal data or secrets in template
• ✅ Ready for immediate use with Hermes/OpenClaw
• ✅ Version: 1.22.8

Your template is now sharper, clearer, and easier to adopt.