@geohar/pi-cribsheet 0.22.1 → 0.23.0-dev2

package/CHANGELOG.md

@@ -9,6 +9,103 @@ This file ships in the Pi package, where Pi shows the entries newer than the
 version you last ran. `scripts/bump-version.sh` refuses a release whose
 version has no heading here.
 
+## [0.23.0-dev2] - 2026-11-13
+
+### Added
+
+- `crib project doctor` (`project_doctor`): what in a project needs
+  attention, report-only, each finding naming the command that fixes it.
+  It checks dangling dependencies; dependencies on a superseded decision
+  (naming its replacement) or a declined plan; cited sections that changed
+  or vanished; moved or orphaned learnings; one id in several files;
+  near-duplicate notes, decisions and plans; and pending descriptions.
+- `crib project related <ref>` (`project_related`): one item's links both
+  ways and its nearest notes, decisions, plans, learnings and symbols.
+- `crib project lookup` (`project_lookup`): one search across notes,
+  decisions, plans and learnings, with `--kind` and `--status` filters.
+- `[generate] mode = "on" | "explicit" | "off"`. Without a models
+  config it is `explicit`: crib generates descriptions, keywords and
+  summaries only when you run a verb that asks for them, and never drives
+  the Claude CLI in the background on its own. Background indexing still
+  saves code structure; `status` counts the descriptions waiting.
+- `status` reports the daemon: uptime, startup milestones, the background
+  work running now, queue depths, and whether file events are arriving.
+  The daemon writes a log, by default `~/.cache/crib/daemon.log`.
+- When file events are delayed (macOS fseventsd under load), the daemon
+  says so and sweeps for changes every two minutes until they recover.
+
+### Changed
+
+- After a note, decision or plan write, `similar` compares the whole item
+  with every note, decision and plan in the project, not just its first
+  line against one pillar. Each match says whether it is a duplicate, a
+  confusingly similar title, already settled (done, declined, parked,
+  superseded) or just related, and what to do. Plan adds return it too.
+- Decision and plan reads list `suggested_deps`: active decisions the item
+  is close to but doesn't depend on, with the command to add the link.
+- `design_import` and `plan_import` name, for each section, the existing
+  decisions or plans closest to it.
+- The learnings report names where an orphaned learning probably went.
+- `dep_add` with a different kind changes an existing dependency's kind
+  and keeps it verified.
+- Summary aliases are embedded once and kept, instead of re-embedded after
+  every daemon start; the keyword index is read from the store.
+
+### Fixed
+
+- `status` no longer shows a git remote's password or token.
+
+### Upgrading
+
+- The store's schema changes again, so the first daemon on this version
+  rebuilds its cache from your files once.
+- If you relied on background generation without a models config, set
+  `[generate] mode = "on"`.
+
+## [0.23.0-dev1] - 2026-11-12
+
+The DuckDB cache now has one uniform shape: an item per note, decision, plan,
+learning or code symbol; one table per kind for that kind's own fields; one
+table of links between items; and the lexical postings. The files stay the
+truth. The store is kept exact by every read and write, and answers the
+queries.
+
+### Added
+
+- Dependency kinds. A dependency can say what it means: `follows` (blocked
+  until the target is done), `rests_on` (blocked while the target is stale)
+  or `informed_by` (checked for change, never blocks). Without one, a dep
+  gets the target's default: a plan is `follows`, a decision `rests_on`, a
+  note `informed_by`. Use `--follows`, `--rests-on`, `--informed-by` or
+  `dep-add --as`; reads report each dep's kind.
+- A plain note can be a dependency target: checked for change, never
+  blocking. It used to read as a deleted dependency.
+
+### Changed
+
+- Code search runs from the store, so crib no longer keeps every project's
+  symbols, keyword index and description vectors in memory. On a 10,000
+  symbol project a warm read of all records takes 0.2 s.
+- Design and plan graph reads parse only files changed since the last read:
+  0.16 s to 0.03 s on a 455-item project.
+- The startup and post-pull reconcile reads only notes changed since they
+  were last indexed: 4.2 s to 0.5 s across 21 projects. An explicit
+  `reindex` still re-reads everything.
+- The watcher refreshes the store as record files, decisions and plans
+  change; reads still catch anything it misses.
+- Decisions written by crib no longer carry an empty `links: []` line.
+
+### Fixed
+
+- Projects that vendor the same file (the same symbol in several projects)
+  no longer overwrite each other's symbols in the store.
+
+### Upgrading
+
+- The store's schema changes, so the first daemon on this version rebuilds
+  its DuckDB cache once from the files. Nothing in your notes, decisions,
+  plans or symbol records changes.
+
 ## [0.22.1] - 2026-11-10
 
 ### Fixed

package/package.json

@@ -1,6 +1,6 @@
 {
     "name": "@geohar/pi-cribsheet",
-    "version": "0.22.1",
+    "version": "0.23.0-dev2",
     "description": "Pi extension: run the crib (cribsheet) memory + code-index MCP server via sharedserver, inject the reach-for-crib directive, and ship the /crib recall command. Pairs with pi-mcp-adapter.",
     "type": "module",
     "main": "dist/index.js",