caveat-cli 0.11.2 → 0.13.0

package/dist/migrations/003_section_roles.sql

@@ -0,0 +1,7 @@
+-- v3: classify each entry's text into role buckets so the surface gate can
+-- demand at least one match in the symptom section ("situational"), not just
+-- topical (title / tags / environment) overlap.
+-- Existing rows have NULL until db.ts backfills from stored body + frontmatter
+-- on first openDb after migration.
+ALTER TABLE entries ADD COLUMN topical_text TEXT;
+ALTER TABLE entries ADD COLUMN symptom_text TEXT;

package/dist/schema.sql

@@ -1,4 +1,4 @@
-PRAGMA user_version = 2;
+PRAGMA user_version = 3;
 
 CREATE TABLE entries (
   rowid INTEGER PRIMARY KEY AUTOINCREMENT,
@@ -14,6 +14,14 @@ CREATE TABLE entries (
   file_mtime TEXT NOT NULL,
   indexed_at TEXT NOT NULL,
   last_hit_at TEXT,
+  -- title + tags + environment values, concatenated. Used at search time to
+  -- classify a matched token as "topical" (the prompt named the entry's
+  -- topic without describing the failure state).
+  topical_text TEXT,
+  -- The entry's `## Symptom` section content. A matched token here is
+  -- "situational" — the prompt is using failure-state vocabulary, not
+  -- merely naming the topic. Surface gate requires ≥ 1 situational match.
+  symptom_text TEXT,
   UNIQUE (source, id)
 );