Skip to content

v1.3.0: Checkpoints - a queryable timeline for every work session

Choose a tag to compare

@Vince-Oswalt Vince-Oswalt released this 10 Jul 17:09
2cffbd8

v1.3.0: Checkpoints - a queryable timeline for every work session

Checkpoints turn the end of a work session into a durable, per-project record you can read back later. Say "checkpoint" (or "wrap up this session") and Founders OS walks the agent through summarizing the session, capturing repo changes as commit links, and storing a structured record, then points the next session at it. No new database entity and no schema migration: checkpoints ride the existing memory store.

Highlights

  • checkpoint tool. The end-of-session bookend to get_session_start. It returns an ordered procedure (summarize, capture repo changes as commit links, store the record, propose follow-up tasks, write the handoff doc), the exact memory call to make, and the previous checkpoint so unfinished items carry forward.
  • get_project_history tool. A chronological, newest-first timeline of a project's checkpoints. It complements semantic recall with a straight "what happened, in order" view. Pass kind: "all" to see everything, not just checkpoints.
  • Session memories carry a kind. memory_store and memory_summarize_and_store now accept a kind (e.g. "checkpoint"), which is what the timeline filters on.
  • Sortable handoff-doc naming. Suggested handoff files now end with a two-digit, per-day sequence: docs/<project>-session-handoff-YYYY-MM-DD-NN.md. 01 is the first session that day, 02 the second, resetting daily, so multiple handoffs on one day sort in true chronological order. Feature docs from the same session share the number so they group together.
  • Works with or without the cowork plugin. The checkpoint verb is documented in the server instructions and get_usage_guide, so any Founders OS user gets it.

Improvements

  • Smarter version diagnostics. get_version and the startup version check now reason correctly about pre-release (rc) versions, so a machine running a release candidate is reported accurately instead of looking out of date.

Maintenance

  • Added a prerelease publish workflow and a RELEASING.md guide.
  • Added glama.json, refreshed README / SECURITY / CODE_OF_CONDUCT for the now-public repo, and expanded the test suite (checkpoint procedure and handoff-naming coverage, rc-aware semver tests).

Upgrade

Make sure your MCP config pins @latest, then fully restart your AI app so it re-resolves:

npx -y @ourthinktank/founders-os@latest

No database migration is required for this release.