pub struct Release {
pub version: &'static str,
pub highlights: &'static [&'static str],
}
pub const RELEASES: &[Release] = &[
Release {
version: "1.0.12",
highlights: &[
"`update` keeps sections and command files you edited, and projects with a [remote] get remote-aware templates instead of git-model text; a second update changes nothing",
"A git worktree without its own [remote] writes to its main checkout's server; with no server anywhere, a write says it stayed local",
"Migrations and imports keep a node's original created_at: a date can move earlier, never later",
"`remote status` and `remote push --seed` agree about edges; large replays go in batches and a timeout says resending is safe",
"ask_graph ranks a node naming a rare term (a version, an identifier) above ones matching only common words",
],
},
Release {
version: "1.0.11",
highlights: &[
"A server on this machine needs PostgreSQL, not Docker: `remote setup --local` runs the release's self-contained server as a background service (launchd / systemd) against the system PostgreSQL on localhost:5432; `--database-url` for any other PostgreSQL, `--docker-postgres` / `--docker` for the old containers; earlier installs stay on Docker",
"The local database follows graph.json: a node added on one branch no longer appears on every branch after `sync`, and checkout, reset, pull and stash are followed by every command",
"sync refuses records `add` and `link` would refuse (unknown types and statuses, self-loops, 2-cycles) and names them; ops that arrive through git carry the time of the edit",
"`/events?since=` replays an event that committed after a higher one; mint 1.11.0 clears three advisories in the server's HTTP client",
"Includes everything in 1.0.10, which was tagged but never published: closed-loop ask_graph, absent-topic stops, file and commit links, parent suggestions, consolidation_report, and five sync and event fixes",
],
},
Release {
version: "1.0.10",
highlights: &[
"ask_graph is a closed loop: trigram and full-text anchors fused by rank, routes by question shape, a budget and an explicit stop_reason; recall@10 0.611 -> 0.889 and MRR 0.264 -> 0.726 on the new eval, 5-11 queries per question instead of 72-152",
"ask_graph says when the graph never recorded a topic (stop_reason distinctive_term_unmatched, unmatched_terms) instead of returning pages of loosely related nodes",
"Nodes naming the same file or commit are related at read time: show_node lists them, query_nodes takes a file, ask_graph follows them",
"add_node without a parent_id answers with ranked parent guesses; find_orphans can too; consolidation_report proposes duplicate goals, missing revisits, stale actions and parents for loose nodes, and changes nothing",
"Sync fixes found by the model battery: a status write no longer reverts an agent's retitle on pull; the git merge driver keeps a status set on a node that arrived only from the server; an edit that changes nothing no longer brings a deleted node back",
"The stdio MCP server never answers with a line that is not JSON; live events written during a database outage, or committed out of order, still reach subscribers",
],
},
Release {
version: "1.0.9",
highlights: &[
"A message board for agents working at the same time: `post_message` and `read_messages` over MCP (server and local), `deciduous board post|read|show` on the CLI; `@label` addresses a message, `reply_to` answers it, `unanswered_for` / `--unanswered` lists what is still owed",
"Coordinate through the board, never a scratch file: every template `init` and `update` write (CLAUDE.md, /decision, /work, /recover, /sync, skills, agents.toml, Windsurf and OpenCode rules, /demo-swarm) now says so, and /recover reads what is waiting for you",
"Locally the board lives in the main worktree's database, so every git worktree of a repository shares one; with a [remote] it lives in the server's Postgres. Messages are not graph nodes: not in graph.json, not exported, not synced",
"`board-mentions.sh` hook: with DECIDUOUS_AGENT_LABEL set, shows that label's unanswered messages at session start and as new ones arrive; silent otherwise",
"Server: agent_messages table (a reply cannot cross workspaces, enforced by a foreign key), POST/GET /messages for the CLI, and a message_posted event on /events that `remote watch` prints",
],
},
Release {
version: "1.0.8",
highlights: &[
"CLI writes go through a local log, .deciduous/remote-log.jsonl, and are replayed on the server one field at a time: an offline edit waits and is sent by the next write or `remote push`, a queued edit never overwrites a newer agent edit to the same field, and `delete`, `unlink`, archaeology and the local MCP server reach the server too",
"`remote status` compares content, not counts, lists what is waiting or was refused, names a fix for each difference, and exits 1 when anything differs; `remote push --seed` and `--repair` send what the log never had",
"A workspace belongs to the repository that first wrote to it (by root commit), so a same-named repository cannot read or write it; worktrees, renames, shallow clones and non-ASCII names keep their workspace",
"A node deleted on the server leaves the local graph on `remote pull`, even over a later local edit, and its content leaves graph.json with it",
"The server holds a workspace pin on every route that names a workspace, hides deleted nodes from every read and write, refuses bad input with a sentence instead of a 500, and no longer creates workspaces on reads or failed writes",
"graph.json keeps every edit: fields a newer version wrote, relinks, edits to future-dated nodes, failed merge-driver merges and pulled server copies are merged, not overwritten; an edit is refused while the file cannot be read",
"SQLite waits for its write lock, graph.json is written under a file lock, ids beyond 32 bits are refused, and attach_document reads only regular files inside the project",
"The log survives a crash: a write and its op commit together, a torn line is set aside, and one op the server cannot store is rejected alone instead of blocking every op behind it",
"Queued deletes and edits respect newer ones: a delete is refused over a newer edit, an unlink leaves a tombstone that reaches clones, and an edit made after a delete brings the node back",
"Every server path refuses undeclared arguments, over-long strings (counted in codepoints) and 2-cycles, and a batch that writes nothing creates and claims no workspace",
"`unlink` removes one edge and refuses to guess between two, a node can be named by its server id, and commands on a detached commit leave graph.json alone",
],
},
Release {
version: "1.0.7",
highlights: &[
"`add`, `link`, `status` and `prompt` send the write to the server after making it locally, so the local database and the graph the agents read stop drifting apart silently; an unreachable server leaves a warning naming `deciduous remote push`, and the local write still stands",
"`delete` and `unlink` say they are local only: the server's /import applies additions and edits, not removals",
"`remote setup --local` suggests a free port in 20000-32767 instead of putting every install on 4000, which is Phoenix's default port; `--port` and DECIDUOUS_PORT answer for scripts, and an install that already has a port keeps it",
],
},
Release {
version: "1.0.6",
highlights: &[
"`init` and `update` ask where a project's graph lives (this machine via Docker, or a server someone else runs) when it has no [remote], instead of setting up a local server unasked; with no terminal they stop and name `remote setup --local` / `--url`",
],
},
Release {
version: "1.0.5",
highlights: &[
"`deciduous init` and `update` make sure the project points at a shared graph server that answers, and fail if it does not. With no remote configured, init sets up PostgreSQL and the server on this machine with Docker from the release's verified bundle, stores the token and registers it with Claude Code",
"DECIDUOUS_NO_SERVER=1 skips that step for tests and CI",
"`deciduous remote setup`: a wizard that connects a project to this machine's server or to one someone else runs",
"GitHub Pages removed: no docs/ viewer, Pages workflow or /sync-graph from init, and sync no longer exports docs/graph-data.json; update removes what deciduous wrote",
],
},
Release {
version: "1.0.4",
highlights: &[
"The MCP server tells every agent when and how to log, in the `instructions` of its initialize reply: no project configuration, and nothing that can block a tool call",
"`/demo-swarm` (iTerm2 or Ghostty): an Opus lead and four Sonnet workers build one Tetris under five rules (functional core, tests first, browser tests of user errors, compiler-checked types, simple over easy), sharing one graph; every pane is recorded for replay. `deciduous demo-swarm --preview` plays the walkthrough alone",
"`deciduous update --help` describes what update changes in .claude/settings.json and what it leaves alone",
],
},
Release {
version: "1.0.3",
highlights: &[
"The log-loop hook is removed: nothing denies an agent's tool calls any more. `deciduous update` deletes the hook scripts and plugins deciduous wrote (keeping any you wrote) and takes `deciduous log-loop` out of .claude/settings.json",
"`deciduous update` keeps what it did not write: files deciduous wrote are replaced, a user's Markdown is kept with the new text appended in a marked block, a user's script or TOML is left alone",
"Everything update changes is backed up first to .deciduous/update-backups/<time>/; on a remote project it no longer touches .gitignore, .gitattributes, .git/config or graph.json",
"`remote push` sends only what the server lacks (--overwrite for the old behaviour); `update --all <dir>` updates every project under a directory",
],
},
Release {
version: "1.0.2",
highlights: &[
"Every MCP tool call has a 60-second deadline: a handler still running is stopped, its uncommitted writes roll back, and the call is answered with an error under its own id instead of hanging past Claude Code's 120-second background cutoff",
"Server warnings and errors reach the log; the bundled Hermes library dropped every message above the configured level",
"ask_graph's text search stays in the workspace it was asked about and skips deleted nodes; it used to match every workspace on the server",
"Agents log as they work: the installed Claude Code hook denies the next tool call after ten actions or an unlogged commit without a graph write, and `deciduous update` merges it into existing projects",
"Trigram indexes serve query_nodes search and ask_graph: a search across all workspaces went from 85 ms to 3 ms on production",
"The shared graph server ships as a Burrito executable with Erlang/OTP and Elixir included; users no longer need to install them separately",
"One-command Docker setup generates private credentials, starts persistent PostgreSQL 17, applies migrations, and waits for readiness; it also supports an existing database and preserves saved settings on repeat runs",
"The server's /ready endpoint checks database access and required migrations; the event listener recovers after a database outage, and DB_SSL=true verifies the database certificate and hostname by default",
"Native installs can bootstrap an empty PostgreSQL database from the release's STRUCTURE.sql; deployment docs cover upgrades and backup restoration that preserves graph data, documents, and database settings",
"Release checks exercise fresh installs, v1.0.0 upgrades, extracted Docker bundles, persistence, authentication, MCP, events, TLS, and backup restoration; native executable checks gate publication on each supported platform",
],
},
Release {
version: "1.0.0",
highlights: &[
"Fix: a Claude Code session idle for 30 minutes found every later MCP call hanging for 300s. The server answered the expired session under a made-up id; it now answers 404 Session not found under the request's id, and sessions live 24 hours",
"Fix: every Claude Code connection paid five seconds before its first call, waiting on a version probe (server/discover) the server answered as a notification; unknown methods now get -32601 under the request id and the client connects in 35ms",
"Several agents, one graph: ten Claude Code sessions in ten worktrees built ten Tetris games against one shared workspace in 26 minutes, 386 nodes, 170 borrowed ideas with provenance — https://notactuallytreyanastasio.github.io/tetris-arena/",
"`took_from` edge type: a borrow is an edge, from the node you took from to your node that used it, across branches. `log_observation` takes `took_from` (UUID or change_id) and writes the observation and the edge in one call; `deciduous link -t took_from` too",
"`check_activity` returns `branches`: the last node on each of the twenty most recently written branches with who holds its lock (`branches: N` for more), so a peer sees what is new without polling query_nodes",
"`deciduous remote watch` connects and prints one quoted line per write — branch, operation, type, title — and reconnects with backoff. `--types`, `--branch`, `--edges`, `--json`; `--url` prints the socket URL for another client",
"Event frames carry the node title and status; edge frames carry the source node's branch. A watcher can quote instead of count",
"Fix: the events socket closed every subscriber after 60s (Bandit's default idle timeout, close 1002). The server pings every 30s now",
"Fix: update_node, delete_node and delete_edge never claimed the branch lock; the 0.19 fix had only added the argument to their schemas. They resolve the node's workspace and claim it now",
"The site leads with the multi-agent story next to memory (/recover) and discovery (ask_graph, workspace \"*\"): docs/remote.html#alongside documents locks, check_activity, events, watch and took_from together",
"Still advisory: a NOTIFY that fires while the listener is down is lost, and a lock is a refusal with a name attached, not a table constraint. check_activity and query_nodes are how you catch up",
],
},
Release {
version: "0.19.0",
highlights: &[
"`deciduous remote` points a project at a shared graph server: one Postgres holds every repository's graph, one workspace each",
"The server is the truth and the local database becomes a cache of it — `remote pull` refreshes, `remote status` reports which side has drifted",
"`remote login` stores the token at ~/.config/deciduous/credentials, mode 0600, outside every repository — it is never written to config.toml",
"`remote adopt <dir>` configures many projects at once, and never repoints one already aimed somewhere else",
"Read tools accept workspace \"*\" for the cross-project view; writes refuse it, because a node has to land somewhere",
"An MCP endpoint serves the graph over HTTP, with documents stored in Postgres and keyed by sha256 so a file attached in several projects is stored once",
"Fix: edges resolve by their integer endpoint before the denormalized change_id, which was stale on 9,185 of 51,158 edges in one graph and silently dropped 11% of an archive on import",
"Fix: `GET /mcp` returns 405. Cloudflare buffers SSE, so the stream Claude Code waits on never opened and every tool call hung for 300s",
"Never put a literal token in .mcp.json — use ${DECIDUOUS_MCP_TOKEN}, which Claude Code expands and names when missing",
"See docs/remote-graph.md to set it up, and deciduous_mcp/DEPLOY.md to run the server",
],
},
Release {
version: "0.18.0",
highlights: &[
"The shared graph is one file again: .deciduous/graph.json holds every node, edge, theme, and tag",
"0.17's .deciduous/sync/ directory (one file per record) is folded into it once by `sync`, `init`, or `update`, then deleted — `git rm -r .deciduous/sync` afterwards",
"Why: a real graph was 2,781 files and 11MB of directory overhead, which made `git status` and PR diffs unreadable for a ~1MB graph",
"The cost: concurrent changes now always conflict in git, so the `deciduous merge-record` driver runs on every merge instead of rarely",
"That driver merges the two documents record by record — both sides' additions survive, and a record both sides changed still merges field by field",
"`deciduous sync` writes the file once per run, not once per record",
"A graph.json that will not parse now stops a sync instead of being treated as an empty graph",
"Run `deciduous update` to fix .gitignore and .gitattributes, then `deciduous sync`",
],
},
Release {
version: "0.17.1",
highlights: &[
"Fix: `deciduous nodes` panicked on observations whose description contains multibyte characters (e.g. an ellipsis)",
],
},
Release {
version: "0.17.0",
highlights: &[
"One multi-user sync mechanism: .deciduous/sync/ holds one JSON record per node/edge/theme/tag, tracked in git",
"Adds never conflict, deletes are tombstones, newer updated_at wins per record; no event log, checkpoint, or patches",
"Records are written by the database layer, so CLI, MCP, and HTTP API all publish automatically",
"`deciduous sync` reconciles both ways then exports docs/graph-data.json; `--check` exits 1 if anything is pending",
"Node references accept a change_id prefix everywhere (CLI and MCP) for linking to teammates' nodes",
"Concurrent edits of one record merge field by field: a git merge driver (`deciduous merge-record`) is registered by init/update/sync, and `deciduous sync` repairs files left with conflict markers",
"Legacy JSONL event logs are imported once (tolerating corrupted lines) and removed; `deciduous events` is a deprecated alias",
"Run `deciduous update` to fix .gitignore (it used to hide all of .deciduous/) and refresh templates",
],
},
Release {
version: "0.16.0",
highlights: &[
"Multi-graph HTTP API daemon (`deciduous serve --api`): many independent graphs over HTTP with bearer-token auth, one SQLite file per graph",
"Lets a graph live centrally and be written to by clients with no local .deciduous/",
"The HTTP API is append-and-read only: delete_node, unlink_nodes, update_status, and update_prompt are refused at the daemon (403), so a token holder cannot erase or rewrite history",
"graph_id is validated before any filesystem access",
"`GET /health`: unauthenticated, side-effect-free liveness endpoint for proxies and uptime probes",
"DECIDUOUS_API_DATA_DIR env var alongside --data-dir, for container and systemd configuration",
"Deployment artifacts: Dockerfile, Caddy auto-TLS reverse proxy, WAL-safe backup script, and a runbook (deploy/)",
"Fixed: a graph whose data directory vanished under a running daemon wedged every later write on a 404; the filesystem is authoritative now",
],
},
Release {
version: "0.15.0",
highlights: &[
"Built-in MCP server: `deciduous mcp` exposes 31 tools over Model Context Protocol",
"Works with Claude Code, Claude Desktop, and cowork",
"Graph CRUD, querying, full-text search, chain tracing, node context, pulse, orphan detection",
"Session management: each conversation gets its own decision tree (start/end/resume)",
"Sessions persist across server restarts for long-running cowork conversations",
"/query slash command for natural language reports from the decision graph",
"Run `deciduous update` to apply to existing projects",
],
},
Release {
version: "0.14.0",
highlights: &[
"Observations now require both a title and description (-d flag)",
"CLI warns when creating observations without a description",
"Observation descriptions shown inline in `deciduous nodes` listing",
"Web viewer detail panel shows observation description prominently below title",
"All templates and instructions updated for observation title+description convention",
"Run `deciduous update` to apply to existing projects",
],
},
Release {
version: "0.13.15",
highlights: &[
"Templates now include 'What NOT to Log' guidance to reduce meta-process noise",
"Decision graph nodes should capture user project decisions, not AI internal process",
"Run `deciduous update` to apply to existing projects",
],
},
Release {
version: "0.13.14",
highlights: &[
"Post-commit hook is now advisory (exit 0) instead of blocking (exit 2)",
"Run `deciduous update` to apply the fix to existing projects",
],
},
Release {
version: "0.13.13",
highlights: &[
"Web viewer sorts narratives by most recent activity instead of tree size",
],
},
Release {
version: "0.13.12",
highlights: &[
"Web viewer now defaults to showing all goals instead of only 10+ node trees",
],
},
Release {
version: "0.13.11",
highlights: &[
"Version checking is now always-on (no opt-in needed)",
"Patch updates show a quiet one-liner notification",
"Minor/major updates show a prominent banner encouraging upgrade",
"Deprecated `deciduous auto-update on/off` and `--no-auto-update` flag",
],
},
Release {
version: "0.13.10",
highlights: &[
"Opt-in auto-update version check hook - checks crates.io once per 24h, non-blocking",
"Toggle with `deciduous auto-update on/off`, or `deciduous init --no-auto-update`",
"Copy markdown button added to Q&A chat responses in web viewer",
"CI: auto-format on push to non-main branches",
],
},
Release {
version: "0.13.9",
highlights: &[
"Fix: OpenCode plugins write to .deciduous/plugin.log instead of console.error (stderr also corrupts TUI)",
"Neither stdout nor stderr is safe for OpenCode TUI - all plugin output now goes to log file",
"Fix: OpenCode install runs directory migration before creating new structure",
],
},
Release {
version: "0.13.8",
highlights: &[
"Fix: OpenCode post-commit hook still used console.log (stdout) instead of console.error (stderr)",
"Completes the stdout fix from 0.13.7 - both pre-edit and post-commit hooks now use stderr",
],
},
Release {
version: "0.13.7",
highlights: &[
"Fix: OpenCode plugin uses console.error instead of console.log to avoid breaking TUI STDOUT",
"require-action-node and post-commit-reminder plugins no longer pollute OpenCode display",
],
},
Release {
version: "0.13.6",
highlights: &[
"decision-graph: new Layer 4 - use gh CLI to find PRs for design context and review discussion",
"PR descriptions and review threads mined for decision rationale, alternatives considered, and trade-offs",
"Updated in both Claude Code and OpenCode templates",
],
},
Release {
version: "0.13.5",
highlights: &[
"OpenCode command templates now match Claude Code verbosity (decision-graph, document, decision, archaeology)",
"decision-graph: added Hardening Phase, Cross-Narrative Connections, Narrative Discipline, Rich Node Content, Edge Types",
"document: added documentation structure template, test refinement step, decision criteria, example usage",
"decision: added Web UI Branch Filter, disconnected node auditing, expanded multi-user sync",
"archaeology skill: added Querying the Graph section and descriptive details",
],
},
Release {
version: "0.13.3",
highlights: &[
"OpenCode bootstrapping upgraded to modern directory conventions (plugins/, commands/, skills/)",
"Skills now use proper SKILL.md format in .opencode/skills/<name>/SKILL.md",
"New: custom deciduous agent in .opencode/agents/deciduous.md",
"New: custom deciduous tool in .opencode/tools/deciduous.ts wraps CLI for direct graph ops",
"Migration logic: deciduous update auto-migrates from old singular dirs to plural",
],
},
Release {
version: "0.13.2",
highlights: &[
"OpenCode integration fully updated to match Claude Code feature parity",
"3 new OpenCode commands: /document, /sync, /decision-graph",
"All 9 OpenCode commands updated with document attachments, event sync, graph integrity",
"All 3 OpenCode skills updated: /pulse, /narratives, /archaeology use latest CLI commands",
"OpenCode plugins improved: .deciduous check, better git commit detection",
"AGENTS.md workflow section now includes full command/skill tables and node flow rule",
],
},
Release {
version: "0.13.1",
highlights: &[
"Fix: deciduous update no longer deletes user content after the Decision Graph Workflow section in CLAUDE.md",
"Added <!-- deciduous:start/end --> markers for safe section replacement",
"Legacy CLAUDE.md files auto-migrate to markers on first update",
"6 new tests for section replacement edge cases",
],
},
Release {
version: "0.13.0",
highlights: &[
"Document attachments: attach files (images, PDFs, diagrams) to decision nodes",
"7 doc subcommands: attach, list, show, describe, open, detach, gc",
"AI-generated descriptions for attached documents (--ai-describe)",
"Content-hash deduplication and soft-delete with garbage collection",
"Theme system: tag and group nodes by theme",
"Web viewer shows attached documents and themes in detail panel",
"REST API: /api/documents and /api/documents/file/<id> endpoints",
"Event-based sync support for document attachments",
"All skills, commands, and docs updated with document awareness",
"Init now creates .deciduous/documents/ directory",
],
},
Release {
version: "0.12.2",
highlights: &[
"README rewritten to lead with /pulse, /archaeology, /narratives skills",
"New Deep Q&A Interface section documenting POST /api/ask and FTS5 search",
"Landing page updated: 1,170+ nodes, 1,020+ edges, 74 days of development",
"Elevator pitch rewritten around three skills and conversational Q&A",
"Revisit node type added to landing page (7 node types)",
"Web viewer section updated with Archaeology view and Q&A panel",
],
},
Release {
version: "0.12.1",
highlights: &[
"Bootstrap all slash commands via init/update: /document, /build-test, /serve-ui, /sync-graph, /decision-graph, /sync",
"Updated CLAUDE.md template with full command and skill reference tables",
"Documentation updated across README, QUICK_REFERENCE, ARCHITECTURE",
],
},
Release {
version: "0.12.0",
highlights: &[
"Redesigned web viewer with hierarchical narrative view",
"Smart narrative detection - filters to significant 10+ node trees",
"D3 DAG flowchart visualization with left-to-right hierarchical layout",
"Full-text search with type filter buttons",
"Resizable panels - drag to resize all sections",
"Gold shimmer effect for selected node highlighting",
"Automatic graph loading when clicking search results",
"Removed 20k+ lines of old scattered components for unified App.tsx",
],
},
Release {
version: "0.11.2",
highlights: &[
"Fix: `deciduous opencode install` now works standalone without `deciduous init`",
"Creates core infrastructure (.deciduous/, config, database path, docs/) automatically",
],
},
Release {
version: "0.11.1",
highlights: &[
"Pre-built binaries for Linux, macOS, and Windows on GitHub Releases",
"Added Linux ARM64 support",
"SHA256 checksums included with releases",
],
},
Release {
version: "0.11.0",
highlights: &[
"OpenCode integration support via `deciduous init` and `deciduous update`",
"New `integration-status` command to check Claude Code and OpenCode setup",
"Auto-generates opencode.json with deciduous plugin configuration",
],
},
Release {
version: "0.10.3",
highlights: &[
"Fix card stack shrinking - cards now render at consistent size",
"Remove node count limits - graphs show all nodes without truncation",
],
},
Release {
version: "0.10.2",
highlights: &[
"Deep linking with parameterized routes (/archaeology/:id, /dag/:nodeId, etc.)",
"Q&A history view with full-text search across all sessions",
"Prompt modal for viewing verbatim user prompts on nodes",
"Improved CardStack navigation and keyboard shortcuts",
"BrowserRouter for cleaner URLs (no more hash fragments)",
],
},
Release {
version: "0.10.1",
highlights: &[
"Fix card stack not appearing when clicking nodes in archaeology view",
"Card stack now shows description, branch, and files by default",
],
},
Release {
version: "0.10.0",
highlights: &[
"Archaeology view is now the default at `deciduous serve`",
"Narrative-focused exploration with AI-powered explanations",
"Session-based card stack UI with keyboard navigation (j/k/g/G/Space)",
"Mobile-responsive with touch swipe gestures",
"Persistent chat history and filters via localStorage",
"Graph performance optimizations for large node counts",
],
},
Release {
version: "0.9.6",
highlights: &[
"Embedded changelog shows what's new when upgrading",
"Update reminder shown after all commands when outdated",
"`check-update` now shows detailed feature list",
],
},
Release {
version: "0.9.5",
highlights: &[
"New `check-update` command - detect when integration files need updating",
"`update` no longer overwrites your configs (settings.json, config.toml, docs/)",
"Version tracking via .deciduous/.version",
],
},
Release {
version: "0.9.4",
highlights: &[
"Improved `update` command help text",
"Better documentation for update workflow",
],
},
Release {
version: "0.9.3",
highlights: &[
"Skills added to init/update: /pulse, /narratives, /archaeology",
"`update` now refreshes skills and agents.toml",
],
},
Release {
version: "0.9.2",
highlights: &[
"New `revisit` node type for pivots and direction changes",
"Orange color coding in web viewer",
],
},
Release {
version: "0.9.1",
highlights: &["Republish of 0.9.0 (yanked)"],
},
Release {
version: "0.9.0",
highlights: &[
"New `--date` flag for backdating nodes",
"Archaeology workflow support",
],
},
Release {
version: "0.8.25",
highlights: &[
"New `delete` command to remove nodes",
"New `unlink` command to remove edges",
],
},
];
pub fn get_releases_between(from_version: &str, to_version: &str) -> Vec<&'static Release> {
let from_parts = parse_version(from_version);
let to_parts = parse_version(to_version);
let mut releases: Vec<&Release> = RELEASES
.iter()
.filter(|r| {
let v = parse_version(r.version);
v > from_parts && v <= to_parts
})
.collect();
releases.reverse();
releases
}
fn parse_version(v: &str) -> (u32, u32, u32) {
let parts: Vec<u32> = v.split('.').filter_map(|p| p.parse().ok()).collect();
(
parts.first().copied().unwrap_or(0),
parts.get(1).copied().unwrap_or(0),
parts.get(2).copied().unwrap_or(0),
)
}
pub fn format_releases(releases: &[&Release]) -> String {
if releases.is_empty() {
return String::new();
}
let mut output = String::new();
for release in releases {
output.push_str(&format!("\n v{}\n", release.version));
for highlight in release.highlights {
output.push_str(&format!(" • {}\n", highlight));
}
}
output
}
pub fn is_patch_only(current: &str, latest: &str) -> bool {
let (cur_major, cur_minor, _) = parse_version(current);
let (lat_major, lat_minor, _) = parse_version(latest);
cur_major == lat_major && cur_minor == lat_minor
}
pub fn check_version_reminder(current_binary_version: &str) -> Option<String> {
let version_file = std::path::Path::new(".deciduous/.version");
if !version_file.exists() {
return None;
}
let installed_version = std::fs::read_to_string(version_file)
.ok()?
.trim()
.to_string();
if installed_version == current_binary_version {
return None;
}
let releases = get_releases_between(&installed_version, current_binary_version);
let feature_count: usize = releases.iter().map(|r| r.highlights.len()).sum();
Some(format!(
"Update available: v{} → v{} ({} new features). Run 'deciduous check-update' for details.",
installed_version, current_binary_version, feature_count
))
}
#[cfg(test)]
mod tests {
use super::*;
#[test]
fn test_parse_version() {
assert_eq!(parse_version("0.9.5"), (0, 9, 5));
assert_eq!(parse_version("1.0.0"), (1, 0, 0));
assert_eq!(parse_version("0.8.25"), (0, 8, 25));
}
#[test]
fn test_get_releases_between() {
let releases = get_releases_between("0.9.3", "0.9.5");
assert_eq!(releases.len(), 2);
assert_eq!(releases[0].version, "0.9.4");
assert_eq!(releases[1].version, "0.9.5");
}
#[test]
fn test_get_releases_between_same_version() {
let releases = get_releases_between("0.9.5", "0.9.5");
assert!(releases.is_empty());
}
#[test]
fn test_is_patch_only() {
assert!(is_patch_only("0.13.10", "0.13.11"));
assert!(is_patch_only("1.2.3", "1.2.9"));
assert!(!is_patch_only("0.13.10", "0.14.0"));
assert!(!is_patch_only("0.13.10", "1.0.0"));
assert!(!is_patch_only("1.0.0", "2.0.0"));
}
#[test]
fn test_format_releases() {
let releases = get_releases_between("0.9.4", "0.9.5");
let formatted = format_releases(&releases);
assert!(formatted.contains("v0.9.5"));
assert!(formatted.contains("check-update"));
}
}