History / Design Decisions

0.15.0: F7 and F34 fixed, the second formal pass counted, writes pushed only when they are writes

mironmax committed Oct 9, 2026

Wiki aligned with the code: benefits, daily use and honest maturity first Every page audited against the source and corrected, then re-checked by a second pass. Home leads with what the memory does, a day with it, how mature it is and what it costs. Installation lists every kg setup item (upkeep opt-in), updates and uninstall. Server-Management and Configuration cover the systemd unit's journal and frozen environment. How-It-Works, Design- Decisions and the API page match the kg mcp transport, paging, credits, fresh tier and rebalance, push of other sessions' writes and the tool schemas; unverifiable history is attributed. Data-and-Backup, Skills- Reference and Visual-Editor match storage, skills and the editor, including project live updates (F6).

claude committed Oct 9, 2026

0.14.0: preload sized per client unit, paged kg_read, per-port state, maintenance credit and the one recency rule

mironmax committed Oct 8, 2026

Remove the Direction page: planning is no longer public

mironmax committed Oct 8, 2026

0.13.0: fresh tier replaces the creation grace; other sessions' writes are pushed

mironmax committed Oct 8, 2026

0.12: install through kg (uv tool install kg-memory + kg setup), kg mcp, kg editor; repo renamed to kg-memory

mironmax committed Oct 5, 2026

0.11.0: experimental Antigravity CLI, compaction reset, current-source corrections

mironmax committed Oct 5, 2026

v0.10.0: Codex CLI, a docs freshness pass, and Research and Direction pages Every page brought up to 0.10.0: the Codex install and hook trust, file recall, chores and their runners, the third graph level, kg_rename_node, current endorsement rules and pass categories, the corrected .prev backup names and the reload-not-restart recovery step, config keys and env vars the server actually reads. Two new pages: Research (the literature read against this system, and what changed because of it) and Direction.

mironmax committed Sep 27, 2026

v0.9.31 docs: one-voice kg-core, search core upgrades, smear detection, write-side nudges

mironmax committed Jul 28, 2026

v0.9.19 docs: compact-core preload (10K hook budget), deduped loud read, visible loading Claude-Session: https://claude.ai/code/session_01GLF7Q6xEGRxrjXCqxXZbba

mironmax committed Jul 3, 2026

v0.9.18 docs: preloaded memory, fixed char budgets, node-centric reads, search v2, kg_useful

mironmax committed Jul 3, 2026

0.9.13: git-first backup story (auto-commit documented), refill single-threshold + skip semantics, security guards (Host/Origin), 5000-token default, log paths, estimator render==charge table

mironmax committed Jun 11, 2026

v0.9.11: align wiki with current code and skill state - Installation.md: six skills (not four); kg-maintain is auto-loaded AND user-invocable, not "hidden." - Skills-Reference.md: replaced stale char-count table; refreshed kg-extract section for Tier 1/Tier 2 model and subsystem/component vocab. - Knowledge-Graph-API.md: kg_search documents RRF ranking and actual return shape (gist + notes + score, not full node body). - Design-Decisions.md, Data-and-Backup.md: token references 3000 → 4000. - Design-Decisions.md: kg_register_session is now part of kg_read (0.9.0). - Server-Management.md: removed broken `migrate` subcommand row; added GET /api/nodes/{level}/{id} (replaces non-existent POST .../recall); systemd section calls the kg-memory shim.

mironmax committed May 22, 2026

v0.9.9: update scoring formula, version bump - Replace "recency/connectedness/richness" with "recency/connectedness + resurrection pass" in comparison tables (richness was dropped in v0.9.9) - Bump version to 0.9.9

mironmax committed May 19, 2026

v0.9.9: update archival scoring docs — two-signal formula, resurrection pass, grace period semantics Drops richness from scoring (rewards verbosity, not value). Documents weighted in/out connectedness, recency via reads, and post-archival resurrection pass.

mironmax committed May 19, 2026

Update wiki for v0.9.1: compaction tuning, comparison with other memory systems - Configuration: grace period and orphan defaults now reference constants.py - Design-Decisions: full comparison table vs MemPalace and Claude Code Auto-Memory - Home: "How It Compares" section with compact table and philosophical summary; version bump to 0.9.1 - How-It-Works: compaction target and grace period reference env vars, not hardcoded days - Day/ratio values throughout generalized to reference constants.py / env vars

mironmax committed Apr 11, 2026

Update wiki for v0.9.0: consolidated tools, new API, token limit 4K - Knowledge-Graph-API.md: complete rewrite for 8-tool API - Installation.md: updated permission list (8 tools, no old names) - How-It-Works.md: kg_read(cwd) replaces register+read flow - Design-Decisions.md: kg_read(cwd, id) replaces kg_recall - Data-and-Backup.md: updated write-through tool list - Skills-Reference.md: kg_progress replaces get/set - Configuration.md: KG_MAX_TOKENS default 4000, updated guidance

mironmax committed Mar 20, 2026

v0.7.2: auto-memory disable step, single CLAUDE.md recommendation, design rationale - Installation: new step to disable built-in auto-memory; single global CLAUDE.md guidance - Installation: troubleshooting entry for memory confusion (auto-memory + project CLAUDE.md conflicts) - Design Decisions: why disable auto-memory and avoid project-level CLAUDE.md files - Home: version bump to 0.7.2

mironmax committed Mar 17, 2026

Update wiki docs: centralized storage, write-through persistence, revised defaults

mironmax committed Mar 16, 2026

Initial wiki: 10 documentation pages

mironmax committed Feb 6, 2026