@balpal4495/quorum 0.1.10 → 0.3.0

package/modules/sentinel/review.ts

@@ -1,6 +1,7 @@
 import { promises as fs } from "fs"
 import path from "path"
 import type { ChronicleEntry } from "../shared/types"
+import { entryText } from "../shared/types"
 import { coverage as runCoverage } from "./coverage"
 
 function extractModule(filePath: string): string {
@@ -192,7 +193,7 @@ export async function reviewContext(
       lines.push(`**${stat.name}/**`)
       const relevant = allEntries.filter(e => stat.entryIds.includes(e.id))
       for (const entry of relevant) {
-        lines.push(`- \`[${entry.id.slice(0, 8)}]\` ${entry.key_insight}`)
+        lines.push(`- \`[${entry.id.slice(0, 8)}]\` ${entryText(entry)}`)
         lines.push(`  *${entry.status} — confidence ${entry.confidence.toFixed(2)}*`)
       }
       lines.push("")

package/modules/setup.ts

@@ -6,6 +6,7 @@ import { createLanceDBStore } from "./oracle/adapters/lance-db"
 import { evaluate } from "./jury/evaluate"
 import { deliberate } from "./council/deliberate"
 import type { LLMProvider, OracleClient } from "./shared/types"
+import { entryText } from "./shared/types"
 import type { JuryInput, JuryOutput, JuryDeps } from "./jury/types"
 import type { CouncilInput, CouncilOutput, CouncilDeps, CouncilModels } from "./council/types"
 
@@ -124,7 +125,7 @@ export async function setup(options: SetupOptions): Promise<Modules> {
       for (const file of missing) {
         const raw = await fs.readFile(path.join(committedDir, file), "utf8")
         const entry = JSON.parse(raw) as import("./shared/types").ChronicleEntry
-        const embeddingText = [entry.key_insight, ...entry.affected_areas].join(" ")
+        const embeddingText = [entryText(entry), ...entry.affected_areas, ...(entry.scope ?? [])].join(" ")
         const vector = await embedder(embeddingText)
         await vectorStore.upsert(entry.id, vector, entry)
       }

package/modules/shared/types.ts

@@ -29,12 +29,19 @@ export type WorkRef = {
 /**
  * A durable knowledge record stored in Chronicle.
  * This is the canonical unit of institutional memory.
+ *
+ * Schema versions:
+ *   v1 (no schema_version field): key_insight is the primary text field.
+ *   v2 (schema_version: 2): decision is the primary text field; key_insight is a copy
+ *       of decision written for backwards compatibility. Always use entryText() to read.
  */
 export type ChronicleEntry = {
   id: string
-  /** The core finding or decision, in one clear sentence. */
+
+  // ── v1 fields (required — always present) ───────────────────────────────
+  /** The core finding or decision, in one clear sentence. v2: copy of decision. */
   key_insight: string
-  /** Parts of the codebase or system this entry applies to. */
+  /** File paths or system areas this entry applies to. Used by Sentinel for file matching. */
   affected_areas: string[]
   status: "validated" | "refuted" | "open"
   /** 0–1. How strongly this was confirmed at write time. */
@@ -48,6 +55,44 @@ export type ChronicleEntry = {
   /** The unit of work that triggered this entry. Used to build SUMMARY.md temporal context. */
   work_ref?: WorkRef
   timestamp: string
+
+  // ── outcome tracking fields (optional — filled in post-execution) ────────────
+  /** Steps that must pass to confirm this decision was correct. */
+  validation_plan?: string[]
+  /** ISO date after which this entry should be re-evaluated for drift. */
+  review_after?: string
+  /** What actually happened after the decision was acted on in production. */
+  post_merge_result?: "successful" | "bug" | "partial" | "rolled-back"
+
+  // ── v2 fields (optional — absent on legacy entries) ──────────────────────
+  /** 2 = decision record format. Absent = v1 legacy entry. */
+  schema_version?: 2
+  /** Short label for this decision. e.g. "auth/session strategy" */
+  topic?: string
+  /** The decision itself — the primary text field in v2. Use entryText() to read. */
+  decision?: string
+  /** Domain/category tags. Additive — does NOT replace affected_areas. e.g. ["auth", "sessions"] */
+  scope?: string[]
+  /** Approaches that were considered but not chosen. */
+  alternatives_considered?: string[]
+  /** Why the alternatives were rejected. */
+  rejected_reason?: string[]
+  /** ID of the Chronicle entry this supersedes. */
+  supersedes?: string | null
+  /** ID of the Chronicle entry that superseded this one. */
+  superseded_by?: string | null
+}
+
+/**
+ * Return the primary text for a Chronicle entry regardless of schema version.
+ * v2 entries use decision; v1 entries use key_insight.
+ * All callsites that render or embed entry text must use this function.
+ *
+ * Accepts any object with key_insight and optional decision — works for both
+ * full ChronicleEntry and Omit<ChronicleEntry, "id" | "timestamp"> from propose().
+ */
+export function entryText(entry: { key_insight: string; decision?: string }): string {
+  return entry.decision ?? entry.key_insight
 }
 
 /**

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@balpal4495/quorum",
-  "version": "0.1.10",
+  "version": "0.3.0",
   "description": "Portable reasoning layer for agentic codebases — Oracle, Jury, Council, Sentinel",
   "type": "module",
   "license": "MIT",
@@ -24,7 +24,7 @@
   },
   "scripts": {
     "init": "node bin/init.js",
-    "test": "vitest run modules/",
+    "test": "vitest run modules/ evals/",
     "test:watch": "vitest modules/",
     "typecheck": "tsc --noEmit"
   },