@balpal4495/quorum 3.6.0 → 3.8.0

package/bin/commands/compass.js

@@ -753,7 +753,13 @@ async function loadLastArtifact(chronicleDir) {
 
 // ── Main ─────────────────────────────────────────────────────────────────────
 
-export async function run(argv) {
+/**
+ * @param {string[]} argv
+ * @param {Function|null} [injectedLlm] - Pre-detected LLM provider. When
+ *   supplied, provider detection is skipped entirely (avoids the ~1.5 s Ollama
+ *   probe on every MCP/serve request).
+ */
+export async function run(argv, injectedLlm) {
   const [subcommand, ...rest] = argv
 
   if (!subcommand || subcommand === "--help" || subcommand === "-h") {
@@ -794,8 +800,8 @@ export async function run(argv) {
   }
 
   const NO_LLM_CMDS = new Set(["map", "opportunities", "behavior", "propose", "outcome"])
-  const provider = NO_LLM_CMDS.has(subcommand) ? null : await detectProvider()
-  const llm = provider?.llm
+  const llm = injectedLlm
+    ?? (NO_LLM_CMDS.has(subcommand) ? null : (await detectProvider())?.llm)
 
   // ── Shared context helper ─────────────────────────────────────────────────
 

package/bin/mcp/server.js

@@ -10,6 +10,10 @@
  *   GET  /api/growth        Memory health report
  *   POST /api/proposals/:id/commit   Human-gate: approve a proposal
  *   DELETE /api/proposals/:id        Reject / delete a proposal
+ *   POST /api/advisor                Ask a question answered from Chronicle (LLM)
+ *   POST /api/check                  Instant risk triage (no LLM)
+ *   POST /api/ingest                 Ingest files, git history, or URLs
+ *   GET  /api/sentinel/drift         Structural drift check
  *
  * MCP also exposes resources:
  *   chronicle://summary      chronicle://proposals
@@ -28,6 +32,10 @@ import {
   toolCoverage,
   toolGrowth,
   toolCompass,
+  toolAdvisor,
+  toolCheck,
+  toolIngest,
+  toolSentinelDrift,
   commitProposal,
   deleteProposal,
   updateProposal,
@@ -318,6 +326,33 @@ export async function createServer({ projectRoot, chronicleDir, llm = null }) {
         return json(res, 200, result)
       }
 
+      // ── REST: advisor ───────────────────────────────────────────────────────
+      if (pathname === "/api/advisor" && req.method === "POST") {
+        const body = await readBody(req)
+        const result = await toolAdvisor({ question: body.question, projectRoot })
+        return json(res, 200, result)
+      }
+
+      // ── REST: check ─────────────────────────────────────────────────────────
+      if (pathname === "/api/check" && req.method === "POST") {
+        const body = await readBody(req)
+        const result = await toolCheck({ outcome: body.outcome ?? "", design: body.design ?? "", projectRoot })
+        return json(res, 200, result)
+      }
+
+      // ── REST: ingest ────────────────────────────────────────────────────────
+      if (pathname === "/api/ingest" && req.method === "POST") {
+        const body = await readBody(req)
+        const result = await toolIngest({ ...body, projectRoot })
+        return json(res, 200, result)
+      }
+
+      // ── REST: sentinel drift ────────────────────────────────────────────────
+      if (pathname === "/api/sentinel/drift" && req.method === "GET") {
+        const result = await toolSentinelDrift({ projectRoot })
+        return json(res, 200, result)
+      }
+
       // ── Web UI ──────────────────────────────────────────────────────────────
       if ((pathname === "/" || pathname === "/index.html") && req.method === "GET") {
         res.writeHead(200, { "content-type": "text/html; charset=utf-8" })

package/bin/mcp/tools.js

@@ -304,22 +304,183 @@ export async function toolCheck({ outcome, design, projectRoot } = {}) {
 export async function toolCompass({ subcommand = "brief", goal, idea, projectRoot } = {}) {
   if (!_llm) return NO_LLM("quorum_compass")
 
-  const { chronicleDir } = await resolve(projectRoot)
-  // Delegate to the compass CLI command handler for now
   const { run: compassRun } = await import("../commands/compass.js")
-  // Capture stdout
+
+  // Capture stdout — always request JSON so there are no ANSI codes
   const captured = []
   const origWrite = process.stdout.write.bind(process.stdout)
   process.stdout.write = (chunk, ...rest) => { captured.push(String(chunk)); return true }
   try {
-    const extraArgs = []
+    const extraArgs = ["--json"]
     if (subcommand === "pathways" && goal) extraArgs.push("--goal", goal)
     if (subcommand === "score"    && idea) extraArgs.push("--idea", idea)
-    await compassRun([subcommand, ...extraArgs])
+    // Pass _llm directly to skip the ~1.5 s provider re-detection on every request
+    await compassRun([subcommand, ...extraArgs], _llm)
   } finally {
     process.stdout.write = origWrite
   }
-  return { subcommand, output: captured.join("").trim() }
+
+  const raw = captured.join("").trim()
+  let data = null
+  try { data = JSON.parse(raw) } catch { /* fallback to raw string below */ }
+  return { subcommand, data, output: data ? null : raw }
+}
+
+/**
+ * Ingest files, git history, or a URL into .chronicle/sources/ and
+ * .chronicle/evidence/ as low-trust drafts (confidence 0.4).
+ * Returns { added, skipped, items } — no console output, no process.exit.
+ */
+export async function toolIngest({ type = "git", paths, since = "P90D", urls, propose = false, projectRoot } = {}) {
+  const { promisify } = await import("util")
+  const { execFile }  = await import("child_process")
+  const { createHash, randomUUID: uuid } = await import("crypto")
+  const execFileAsync = promisify(execFile)
+
+  const { projectRoot: root, chronicleDir } = await resolve(projectRoot)
+  const sourcesDir   = path.join(chronicleDir, "sources")
+  const evidenceDir  = path.join(chronicleDir, "evidence")
+  const proposalsDir = path.join(chronicleDir, "proposals")
+  await fs.mkdir(sourcesDir,  { recursive: true })
+  await fs.mkdir(evidenceDir, { recursive: true })
+  if (propose) await fs.mkdir(proposalsDir, { recursive: true })
+
+  // Load existing content hashes to skip duplicates
+  const existingHashes = new Set()
+  for (const f of await fs.readdir(sourcesDir).catch(() => [])) {
+    if (!f.endsWith(".json")) continue
+    try {
+      const s = JSON.parse(await fs.readFile(path.join(sourcesDir, f), "utf8"))
+      if (s.content_hash) existingHashes.add(s.content_hash)
+    } catch { /* skip malformed */ }
+  }
+
+  async function writeRecord({ hash, kind, sourceRef, title, summary, scope }) {
+    const id = uuid()
+    const ts = new Date().toISOString()
+    await fs.writeFile(path.join(sourcesDir, `${id}.json`), JSON.stringify(
+      { id, kind, source_ref: sourceRef, content_hash: hash, ingested_at: ts, schema_version: 2 }, null, 2), "utf8")
+
+    const evidenceId = uuid()
+    const evidence = {
+      id: evidenceId, schema_version: 2,
+      topic: `ingest/${kind}/${title.slice(0, 40).replace(/\s+/g, "-").toLowerCase()}`,
+      key_insight: summary.slice(0, 200), decision: summary.slice(0, 200),
+      scope, affected_areas: [], status: "open", confidence: 0.4,
+      source_quality: "metadata-derived", needs_human_summary: true,
+      source_module: "ingest", evidence_cited: [],
+      alternatives_considered: [], rejected_reason: [],
+      ingested_at: ts, source_id: id,
+    }
+    await fs.writeFile(path.join(evidenceDir, `${evidenceId}.json`), JSON.stringify(evidence, null, 2), "utf8")
+    if (propose) {
+      const propId = uuid()
+      await fs.writeFile(path.join(proposalsDir, `${propId}.json`), JSON.stringify({ ...evidence, id: propId }, null, 2), "utf8")
+    }
+  }
+
+  let added = 0, skipped = 0
+  const items = []
+
+  if (type === "git") {
+    // Parse ISO 8601 duration PnD/PnM/PnY safely — never raw user input to shell
+    const match = /^P(?:(\d+)Y)?(?:(\d+)M)?(?:(\d+)D)?$/.exec(since ?? "P90D")
+    const days = match ? (parseInt(match[1] ?? "0") * 365 + parseInt(match[2] ?? "0") * 30 + parseInt(match[3] ?? "0")) : 90
+    const sinceArg = `${days > 0 ? days : 90} days ago`
+
+    let stdout
+    try {
+      const res = await execFileAsync("git", ["log", `--since=${sinceArg}`, "--format=%H|%s|%ae|%ad", "--date=iso"], { cwd: root })
+      stdout = res.stdout.trim()
+    } catch { return { added: 0, skipped: 0, items: [], error: "git log failed — is this a git repository?" } }
+
+    for (const line of stdout.split("\n").filter(Boolean)) {
+      const [commitHash, subject = ""] = line.split("|")
+      if (!commitHash) continue
+      const fingerprint = createHash("sha256").update(commitHash).digest("hex").slice(0, 16)
+      if (existingHashes.has(fingerprint)) { skipped++; continue }
+      const short = commitHash.slice(0, 7)
+      await writeRecord({ hash: fingerprint, kind: "git-commit", sourceRef: commitHash, title: subject, summary: `${short}: ${subject}`, scope: ["source", "git"] })
+      items.push({ ref: short, summary: subject.slice(0, 80) })
+      added++
+    }
+  } else if (type === "url") {
+    const urlList = Array.isArray(urls) ? urls : (urls ? [urls] : [])
+    for (const u of urlList.filter(Boolean)) {
+      let parsed
+      try { parsed = new URL(u) } catch { skipped++; continue }
+      if (!["http:", "https:"].includes(parsed.protocol)) { skipped++; continue }
+      const fingerprint = createHash("sha256").update(u).digest("hex").slice(0, 16)
+      if (existingHashes.has(fingerprint)) { skipped++; continue }
+      let text = ""
+      try {
+        const res = await fetch(u, { signal: AbortSignal.timeout(15000) })
+        const html = await res.text()
+        text = html.replace(/<[^>]+>/g, " ").replace(/\s+/g, " ").trim().slice(0, 2000)
+      } catch { skipped++; continue }
+      const title = parsed.pathname.split("/").filter(Boolean).pop() ?? parsed.hostname
+      const summary = text.slice(0, 200) || u
+      await writeRecord({ hash: fingerprint, kind: "url", sourceRef: u, title, summary, scope: ["docs"] })
+      items.push({ ref: u.slice(0, 60), summary: summary.slice(0, 80) })
+      added++
+    }
+  } else if (type === "files") {
+    const TEXT_EXTS = new Set([".md", ".txt", ".js", ".mjs", ".ts", ".tsx", ".jsx", ".json", ".yaml", ".yml", ".toml", ".sh", ".html", ".css", ".csv"])
+    const pathList = Array.isArray(paths) ? paths : (paths ? String(paths).split(",").map(p => p.trim()) : [])
+    for (const p of pathList.filter(Boolean)) {
+      const abs = path.isAbsolute(p) ? p : path.join(root, p)
+      if (!TEXT_EXTS.has(path.extname(abs).toLowerCase())) { skipped++; continue }
+      let content
+      try { content = await fs.readFile(abs, "utf8") } catch { skipped++; continue }
+      const fingerprint = createHash("sha256").update(content.slice(0, 3000)).digest("hex").slice(0, 16)
+      if (existingHashes.has(fingerprint)) { skipped++; continue }
+      const rel = path.relative(root, abs).replace(/\\/g, "/")
+      const lines = content.split("\n").map(l => l.trim()).filter(Boolean)
+      const summary = (lines.find(l => l.startsWith("#")) ?? lines[0] ?? rel).replace(/^#+\s*/, "").slice(0, 200)
+      await writeRecord({ hash: fingerprint, kind: "file", sourceRef: rel, title: path.basename(abs), summary, scope: ["docs"] })
+      items.push({ ref: rel, summary: summary.slice(0, 80) })
+      added++
+    }
+  }
+
+  return { added, skipped, items: items.slice(0, 30) }
+}
+
+/**
+ * Structural drift check — Chronicle entries whose affected_areas paths no
+ * longer exist as files in the codebase. LLM-free and fast.
+ */
+export async function toolSentinelDrift({ projectRoot } = {}) {
+  const { projectRoot: root, chronicleDir } = await resolve(projectRoot)
+  const entries = await readCommitted(chronicleDir)
+
+  const flags = []
+  for (const entry of entries) {
+    if (!entry.affected_areas?.length) continue
+    const missingFiles = []
+    for (const area of entry.affected_areas) {
+      const abs = path.join(root, area)
+      const exists = await fs.access(abs).then(() => true).catch(() => false)
+      if (!exists) missingFiles.push(area)
+    }
+    if (missingFiles.length > 0) {
+      flags.push({
+        entryId:      (entry.id ?? "").slice(0, 8),
+        topic:        entry.topic,
+        decision:     (entry.decision ?? entry.key_insight ?? "").slice(0, 160),
+        missingFiles,
+        confidence:   entry.confidence,
+        status:       entry.status,
+      })
+    }
+  }
+
+  return {
+    total:   entries.length,
+    flagged: flags.length,
+    flags,
+    note: "Structural check: entries whose affected_areas paths no longer exist. For semantic drift (did the code meaning change?) run: quorum sentinel --drift from the CLI.",
+  }
 }
 
 /**

package/bin/ui/app.html

@@ -408,18 +408,316 @@
   .hint-stalled  { color: var(--red); }
 
   /* ── Compass ── */
-  .compass-output {
+  .cp-header {
+    display: flex;
+    align-items: baseline;
+    gap: 10px;
+    margin-bottom: 14px;
+  }
+  .cp-title {
+    font-size: 15px;
+    font-weight: 700;
+    color: var(--text);
+  }
+  .cp-badge {
+    font-size: 11px;
+    padding: 2px 8px;
+    border-radius: 20px;
+    font-weight: 600;
+    letter-spacing: .03em;
+  }
+  .cp-badge--hi   { background: rgba(52,201,122,.15); color: var(--green); }
+  .cp-badge--mid  { background: rgba(224,185,82,.15);  color: var(--yellow); }
+  .cp-badge--lo   { background: rgba(224,82,82,.15);   color: var(--red); }
+  .cp-direction {
+    font-size: 14px;
+    font-weight: 500;
+    color: var(--text);
+    line-height: 1.6;
+    margin-bottom: 20px;
+    padding: 12px 14px;
+    background: rgba(124,110,255,.08);
+    border-left: 3px solid var(--accent);
+    border-radius: 0 var(--radius) var(--radius) 0;
+  }
+  .cp-section {
+    margin-bottom: 16px;
+  }
+  .cp-section-label {
+    font-size: 11px;
+    font-weight: 700;
+    text-transform: uppercase;
+    letter-spacing: .08em;
+    color: var(--muted);
+    margin-bottom: 6px;
+  }
+  .cp-list {
+    list-style: none;
+    display: flex;
+    flex-direction: column;
+    gap: 5px;
+  }
+  .cp-item {
+    display: flex;
+    gap: 8px;
+    font-size: 13px;
+    line-height: 1.5;
+  }
+  .cp-icon {
+    flex-shrink: 0;
+    width: 16px;
+    text-align: center;
+    margin-top: 1px;
+  }
+  .cp-known   .cp-icon { color: var(--green); }
+  .cp-inferred .cp-icon { color: var(--yellow); }
+  .cp-unknown  .cp-icon { color: var(--muted); }
+  .cp-next-step {
+    margin-top: 20px;
+    padding: 12px 14px;
     background: var(--surface);
     border: 1px solid var(--border);
     border-radius: var(--radius);
-    padding: 16px;
-    font-family: var(--mono);
+    display: flex;
+    flex-direction: column;
+    gap: 4px;
+  }
+  .cp-next-label {
+    font-size: 11px;
+    font-weight: 700;
+    text-transform: uppercase;
+    letter-spacing: .08em;
+    color: var(--muted);
+  }
+  .cp-next-text {
+    font-size: 13px;
+    color: var(--text);
+    line-height: 1.5;
+  }
+  /* map / bets / opportunities */
+  .cp-card {
+    background: var(--surface);
+    border: 1px solid var(--border);
+    border-radius: var(--radius);
+    padding: 14px;
+    margin-bottom: 10px;
+  }
+  .cp-card-header {
+    display: flex;
+    align-items: center;
+    gap: 10px;
+    margin-bottom: 6px;
+  }
+  .cp-card-title {
+    font-size: 13px;
+    font-weight: 600;
+    color: var(--text);
+    flex: 1;
+  }
+  .cp-card-score {
     font-size: 12px;
-    white-space: pre-wrap;
+    font-weight: 700;
+    padding: 2px 8px;
+    border-radius: 20px;
+  }
+  .cp-score-hi  { background: rgba(52,201,122,.15); color: var(--green); }
+  .cp-score-mid { background: rgba(224,185,82,.15);  color: var(--yellow); }
+  .cp-score-lo  { background: rgba(110,110,126,.15); color: var(--muted); }
+  .cp-card-body {
+    font-size: 13px;
     color: var(--muted);
-    max-height: 500px;
+    line-height: 1.5;
+  }
+  .cp-card-meta {
+    font-size: 12px;
+    color: var(--muted);
+    margin-top: 6px;
+  }
+  .cp-card-meta span { margin-right: 12px; }
+  .cp-area-tag {
+    display: inline-block;
+    font-size: 11px;
+    padding: 1px 6px;
+    border-radius: 4px;
+    background: rgba(82,168,224,.12);
+    color: var(--blue);
+    margin-right: 4px;
+  }
+  .cp-gap-item {
+    font-size: 13px;
+    color: var(--yellow);
+    padding: 8px 12px;
+    border-left: 2px solid var(--yellow);
+    margin-bottom: 6px;
+    background: rgba(224,185,82,.05);
+    border-radius: 0 var(--radius) var(--radius) 0;
+  }
+
+  /* ── Advisor chat ── */
+  .chat-wrap {
+    display: flex;
+    flex-direction: column;
+    gap: 16px;
+    max-height: 520px;
     overflow-y: auto;
+    padding-bottom: 4px;
+    margin-bottom: 14px;
+  }
+  .chat-bubble {
+    display: flex;
+    flex-direction: column;
+    gap: 5px;
+    max-width: 92%;
+  }
+  .chat-bubble--user { align-self: flex-end; }
+  .chat-bubble--ai   { align-self: flex-start; }
+  .chat-label {
+    font-size: 11px;
+    font-weight: 700;
+    text-transform: uppercase;
+    letter-spacing: .06em;
+    color: var(--muted);
+  }
+  .chat-bubble--user .chat-label { text-align: right; }
+  .chat-body {
+    font-size: 13px;
     line-height: 1.6;
+    padding: 10px 14px;
+    border-radius: var(--radius);
+  }
+  .chat-bubble--user .chat-body {
+    background: rgba(124,110,255,.15);
+    color: var(--text);
+    border-radius: var(--radius) var(--radius) 2px var(--radius);
+  }
+  .chat-bubble--ai .chat-body {
+    background: var(--surface);
+    border: 1px solid var(--border);
+    color: var(--text);
+    border-radius: 2px var(--radius) var(--radius) var(--radius);
+  }
+  .chat-citations {
+    display: flex;
+    flex-wrap: wrap;
+    gap: 4px;
+    margin-top: 4px;
+  }
+  .chat-citation {
+    font-size: 11px;
+    font-family: var(--mono);
+    padding: 2px 6px;
+    border-radius: 4px;
+    background: rgba(82,168,224,.1);
+    color: var(--blue);
+  }
+  .chat-confidence {
+    font-size: 11px;
+    color: var(--muted);
+    margin-top: 4px;
+  }
+  .chat-input-row {
+    display: flex;
+    gap: 8px;
+  }
+  .chat-input-row input {
+    flex: 1;
+    padding: 10px 14px;
+    background: var(--surface);
+    border: 1px solid var(--border);
+    border-radius: var(--radius);
+    color: var(--text);
+    font: inherit;
+    font-size: 13px;
+    outline: none;
+    transition: border-color .15s;
+  }
+  .chat-input-row input:focus { border-color: var(--accent); }
+
+  /* ── Check ── */
+  .risk-banner {
+    display: flex;
+    align-items: center;
+    gap: 12px;
+    padding: 14px 16px;
+    border-radius: var(--radius);
+    margin-bottom: 16px;
+    border: 1px solid var(--border);
+  }
+  .risk-level {
+    font-size: 18px;
+    font-weight: 800;
+    text-transform: uppercase;
+    letter-spacing: .06em;
+  }
+  .risk-critical { background: rgba(224,82,82,.12);   color: var(--red);    border-color: rgba(224,82,82,.3); }
+  .risk-high     { background: rgba(224,185,82,.12);  color: var(--yellow); border-color: rgba(224,185,82,.3); }
+  .risk-medium   { background: rgba(82,168,224,.10);  color: var(--blue);   border-color: rgba(82,168,224,.3); }
+  .risk-low      { background: rgba(52,201,122,.10);  color: var(--green);  border-color: rgba(52,201,122,.3); }
+  .preflight-row {
+    display: flex;
+    align-items: center;
+    gap: 8px;
+    font-size: 13px;
+    margin-bottom: 6px;
+  }
+  .preflight-ok  { color: var(--green); }
+  .preflight-bad { color: var(--yellow); }
+
+  /* ── Ingest ── */
+  .ingest-section {
+    background: var(--surface);
+    border: 1px solid var(--border);
+    border-radius: var(--radius);
+    padding: 16px;
+    margin-bottom: 14px;
+  }
+  .ingest-section-title {
+    font-size: 13px;
+    font-weight: 700;
+    margin-bottom: 10px;
+    color: var(--text);
+  }
+  .ingest-result {
+    margin-top: 10px;
+    font-size: 12px;
+    font-family: var(--mono);
+    color: var(--muted);
+    line-height: 1.8;
+  }
+
+  /* ── Sentinel drift ── */
+  .drift-flag {
+    background: var(--surface);
+    border: 1px solid var(--border);
+    border-left: 3px solid var(--yellow);
+    border-radius: 0 var(--radius) var(--radius) 0;
+    padding: 12px 14px;
+    margin-bottom: 10px;
+  }
+  .drift-flag-title {
+    font-size: 13px;
+    font-weight: 600;
+    color: var(--text);
+    margin-bottom: 4px;
+  }
+  .drift-flag-body {
+    font-size: 12px;
+    color: var(--muted);
+    line-height: 1.5;
+  }
+  .drift-missing {
+    display: flex;
+    flex-wrap: wrap;
+    gap: 4px;
+    margin-top: 6px;
+  }
+  .drift-path {
+    font-family: var(--mono);
+    font-size: 11px;
+    padding: 2px 6px;
+    background: rgba(224,82,82,.1);
+    color: var(--red);
+    border-radius: 4px;
   }
 
   /* ── Edit modal ── */
@@ -536,6 +834,14 @@
     <button onclick="showTab('coverage')">Coverage</button>
     <button onclick="showTab('growth')">Growth</button>
     <button onclick="showTab('compass')">Compass</button>
+    <button onclick="showTab('advisor')">Advisor</button>
+    <button onclick="showTab('check')">Check</button>
+    <button onclick="showTab('ingest')">Ingest</button>
+    <button onclick="showTab('sentinel')">Sentinel</button>
+    <button onclick="showTab('advisor')">Advisor</button>
+    <button onclick="showTab('check')">Check</button>
+    <button onclick="showTab('ingest')">Ingest</button>
+    <button onclick="showTab('sentinel')">Sentinel</button>
   </nav>
 </header>
 
@@ -584,6 +890,98 @@
     </div>
     <div id="compassView"><div class="empty">Select a subcommand and click Run.<small>Requires an LLM provider configured for quorum serve.</small></div></div>
   </div>
+
+  <!-- ── Advisor tab ──────────────────────────────────────────────── -->
+  <div id="tab-advisor" class="tab">
+    <h2 class="section-heading">Advisor</h2>
+    <p class="section-sub">Ask plain-language questions answered from Chronicle memory.</p>
+    <div class="chat-wrap" id="advisorChat"></div>
+    <div class="chat-input-row">
+      <input id="advisorInput" type="text" placeholder="Ask anything about your codebase…" autocomplete="off"
+        onkeydown="if(event.key==='Enter'&&!event.shiftKey){event.preventDefault();sendAdvisorMsg()}">
+      <button class="btn" onclick="sendAdvisorMsg()">Ask</button>
+    </div>
+    <p style="font-size:12px;color:var(--muted);margin-top:8px">Requires an LLM provider. Answers are grounded in Chronicle entries.</p>
+  </div>
+
+  <!-- ── Check tab ────────────────────────────────────────────────── -->
+  <div id="tab-check" class="tab">
+    <h2 class="section-heading">Risk Check</h2>
+    <p class="section-sub">Instant risk triage against known sensitive patterns — no LLM required.</p>
+    <div style="display:grid;grid-template-columns:1fr 1fr;gap:12px;margin-bottom:12px">
+      <div class="field">
+        <label>Outcome (what changes)</label>
+        <textarea id="checkOutcome" rows="5" placeholder="e.g. Add JWT refresh token rotation to the auth service…"></textarea>
+      </div>
+      <div class="field">
+        <label>Design / approach</label>
+        <textarea id="checkDesign" rows="5" placeholder="e.g. Store tokens in Redis with 7-day TTL, invalidate on logout…"></textarea>
+      </div>
+    </div>
+    <button class="btn" onclick="runCheck()">Check risk</button>
+    <div id="checkResult" style="margin-top:16px"></div>
+  </div>
+
+  <!-- ── Ingest tab ───────────────────────────────────────────────── -->
+  <div id="tab-ingest" class="tab">
+    <h2 class="section-heading">Ingest</h2>
+    <p class="section-sub">Add low-trust evidence to Chronicle from git history, files, or URLs. Nothing is committed automatically — run <code style="font-family:var(--mono);font-size:12px">quorum commit --list</code> to review.</p>
+
+    <div class="ingest-section">
+      <div class="ingest-section-title">Git history</div>
+      <div style="display:flex;gap:10px;align-items:flex-end;flex-wrap:wrap">
+        <div class="field" style="margin:0;flex:1;min-width:140px">
+          <label>Since (ISO 8601 duration)</label>
+          <input id="ingestGitSince" type="text" value="P90D" placeholder="P90D">
+        </div>
+        <div style="display:flex;align-items:center;gap:6px;padding-bottom:1px">
+          <input type="checkbox" id="ingestGitPropose">
+          <label for="ingestGitPropose" style="font-size:13px">Also stage as proposals</label>
+        </div>
+        <button class="btn" style="flex:none" onclick="runIngest('git')">Ingest commits</button>
+      </div>
+      <div class="ingest-result" id="ingestGitResult"></div>
+    </div>
+
+    <div class="ingest-section">
+      <div class="ingest-section-title">Files</div>
+      <div style="display:flex;gap:10px;align-items:flex-end;flex-wrap:wrap">
+        <div class="field" style="margin:0;flex:1;min-width:200px">
+          <label>Paths (comma-separated, relative to project root)</label>
+          <input id="ingestFilePaths" type="text" placeholder="docs/RFC.md, src/lib/triage.ts">
+        </div>
+        <div style="display:flex;align-items:center;gap:6px;padding-bottom:1px">
+          <input type="checkbox" id="ingestFilePropose">
+          <label for="ingestFilePropose" style="font-size:13px">Also stage as proposals</label>
+        </div>
+        <button class="btn" style="flex:none" onclick="runIngest('files')">Ingest files</button>
+      </div>
+      <div class="ingest-result" id="ingestFileResult"></div>
+    </div>
+
+    <div class="ingest-section">
+      <div class="ingest-section-title">URL</div>
+      <div style="display:flex;gap:10px;align-items:flex-end;flex-wrap:wrap">
+        <div class="field" style="margin:0;flex:1;min-width:260px">
+          <label>URL (http/https only)</label>
+          <input id="ingestUrl" type="text" placeholder="https://example.com/rfc">
+        </div>
+        <div style="display:flex;align-items:center;gap:6px;padding-bottom:1px">
+          <input type="checkbox" id="ingestUrlPropose">
+          <label for="ingestUrlPropose" style="font-size:13px">Also stage as proposals</label>
+        </div>
+        <button class="btn" style="flex:none" onclick="runIngest('url')">Ingest URL</button>
+      </div>
+      <div class="ingest-result" id="ingestUrlResult"></div>
+    </div>
+  </div>
+
+  <!-- ── Sentinel tab ─────────────────────────────────────────────── -->
+  <div id="tab-sentinel" class="tab">
+    <h2 class="section-heading">Sentinel</h2>
+    <p class="section-sub">Chronicle entries whose referenced files no longer exist — structural drift detection.</p>
+    <div id="sentinelView"><div class="loading">Loading…</div></div>
+  </div>
 </main>
 
 <!-- ── Edit proposal modal ───────────────────────────────────────────── -->
@@ -640,7 +1038,7 @@ window.addEventListener("DOMContentLoaded", () => {
 
 // ── Tab switching ──────────────────────────────────────────────────────────
 
-const TAB_NAMES = ["chronicle", "proposals", "coverage", "growth", "compass"]
+const TAB_NAMES = ["chronicle", "proposals", "coverage", "growth", "compass", "advisor", "check", "ingest", "sentinel"]
 
 function showTab(name) {
   document.querySelectorAll(".tab").forEach(t => t.classList.remove("active"))
@@ -649,8 +1047,9 @@ function showTab(name) {
   })
   document.getElementById(`tab-${name}`).classList.add("active")
   activeTab = name
-  if (name === "coverage" && !coverageData) loadCoverage()
-  if (name === "growth"   && !growthData)   loadGrowth()
+  if (name === "coverage"  && !coverageData) loadCoverage()
+  if (name === "growth"    && !growthData)   loadGrowth()
+  if (name === "sentinel"  && !sentinelLoaded) loadSentinel()
 }
 
 // ── Toast ──────────────────────────────────────────────────────────────────
@@ -1072,17 +1471,331 @@ async function loadCompass() {
   }
 }
 
+function confidenceBadge(conf) {
+  const pct = Math.round((conf ?? 0) * 100)
+  const cls = pct >= 70 ? 'cp-badge--hi' : pct >= 45 ? 'cp-badge--mid' : 'cp-badge--lo'
+  return `<span class="cp-badge ${cls}">${pct}% confidence</span>`
+}
+
+function cpList(items, cssClass, icon) {
+  if (!items?.length) return ''
+  return `<ul class="cp-list">${items.map(t => `<li class="cp-item ${cssClass}"><span class="cp-icon">${icon}</span><span>${esc(t)}</span></li>`).join('')}</ul>`
+}
+
+function scoreClass(total) {
+  return total >= 75 ? 'cp-score-hi' : total >= 55 ? 'cp-score-mid' : 'cp-score-lo'
+}
+
+function renderBrief(d) {
+  let html = `<div class="cp-header"><span class="cp-title">Direction Brief</span>${confidenceBadge(d.confidence)}</div>`
+  if (d.product_direction) html += `<div class="cp-direction">${esc(d.product_direction)}</div>`
+
+  if (d.known_from_chronicle?.length) {
+    html += `<div class="cp-section"><div class="cp-section-label">From Chronicle</div>${cpList(d.known_from_chronicle, 'cp-known', '✓')}</div>`
+  }
+  if (d.known_from_behavior?.length) {
+    html += `<div class="cp-section"><div class="cp-section-label">From code / docs</div>${cpList(d.known_from_behavior, 'cp-known', '✓')}</div>`
+  }
+  if (d.inferred?.length) {
+    html += `<div class="cp-section"><div class="cp-section-label">Inferred</div>${cpList(d.inferred, 'cp-inferred', '~')}</div>`
+  }
+  if (d.unknowns?.length) {
+    html += `<div class="cp-section"><div class="cp-section-label">Unknowns</div>${cpList(d.unknowns, 'cp-unknown', '?')}</div>`
+  }
+  if (d.assumptions?.length) {
+    html += `<div class="cp-section"><div class="cp-section-label">Assumptions</div>${cpList(d.assumptions, 'cp-unknown', '·')}</div>`
+  }
+  if (d.recommended_next_step) {
+    html += `<div class="cp-next-step"><span class="cp-next-label">Next step</span><span class="cp-next-text">${esc(d.recommended_next_step)}</span></div>`
+  }
+  return html
+}
+
+function renderMap(d) {
+  let html = `<div class="cp-header"><span class="cp-title">Behaviour Map</span>${confidenceBadge(d.confidence)}</div>`
+  if (d.behaviors?.length) {
+    html += `<div class="cp-section"><div class="cp-section-label">Behaviours (${d.behaviors.length})</div>`
+    for (const b of d.behaviors.slice(0, 30)) {
+      html += `<div class="cp-card" style="padding:10px 14px">`
+      html += `<div class="cp-card-header"><span class="cp-card-title">${esc(b.name)}</span><span class="cp-area-tag">${esc(b.area)}</span></div>`
+      html += `<div class="cp-card-body">${esc(b.current_behavior)}</div></div>`
+    }
+    html += `</div>`
+  }
+  if (d.gaps?.length) {
+    html += `<div class="cp-section"><div class="cp-section-label">Gaps (${d.gaps.length})</div>`
+    for (const g of d.gaps) html += `<div class="cp-gap-item">${esc(g.gap)}</div>`
+    html += `</div>`
+  }
+  if (!d.behaviors?.length && !d.gaps?.length) html += `<div class="empty">No behaviours found in this project.</div>`
+  return html
+}
+
+function renderBets(items) {
+  if (!items?.length) return `<div class="empty">No bets generated.</div>`
+  let html = `<div class="cp-header"><span class="cp-title">Strategic Bets</span></div>`
+  for (const b of items) {
+    const total = b.scores?.total ?? 0
+    html += `<div class="cp-card">`
+    html += `<div class="cp-card-header"><span class="cp-card-title">${esc(b.title)}</span><span class="cp-card-score ${scoreClass(total)}">${total}</span></div>`
+    if (b.thesis) html += `<div class="cp-card-body">${esc(b.thesis)}</div>`
+    if (b.first_experiment) html += `<div class="cp-card-meta"><span>First test: ${esc(b.first_experiment)}</span></div>`
+    if (b.kill_criteria?.[0]) html += `<div class="cp-card-meta" style="color:var(--red)">Kill if: ${esc(b.kill_criteria[0])}</div>`
+    if (b.assumptions?.length) html += `<div class="cp-card-meta">Assumes: ${esc(b.assumptions[0])}</div>`
+    html += `</div>`
+  }
+  return html
+}
+
+function renderOpportunities(items) {
+  if (!items?.length) return `<div class="empty">No gaps or opportunities found.</div>`
+  let html = `<div class="cp-header"><span class="cp-title">Opportunities (${items.length})</span></div>`
+  for (const o of items) {
+    html += `<div class="cp-card">`
+    html += `<div class="cp-card-header"><span class="cp-card-title">${esc(o.title ?? o.gap)}</span><span class="cp-area-tag">${esc(o.area)}</span></div>`
+    if (o.why_it_matters) html += `<div class="cp-card-body">${esc(o.why_it_matters)}</div>`
+    if (o.suggested_next_step) html += `<div class="cp-card-meta">Next: ${esc(o.suggested_next_step)}</div>`
+    html += `</div>`
+  }
+  return html
+}
+
 function renderCompass(data, subcommand) {
   const el = document.getElementById("compassView")
   if (data.status === "no-llm") {
     el.innerHTML = `<div class="empty">${esc(data.message)}<small>Set ANTHROPIC_API_KEY, OPENAI_API_KEY, or GEMINI_API_KEY and restart quorum serve.</small></div>`
     return
   }
-  const output = data.output ?? JSON.stringify(data, null, 2)
-  el.innerHTML = `
-    <div style="font-size:12px;color:var(--muted);margin-bottom:10px">compass ${esc(subcommand)}</div>
-    <div class="compass-output">${esc(output)}</div>
-  `
+
+  const d = data.data  // structured JSON from compass --json
+  if (!d) {
+    // fallback: raw text (shouldn't happen, but safe)
+    el.innerHTML = `<pre style="font-size:12px;line-height:1.6;white-space:pre-wrap;color:var(--muted)">${esc(data.output ?? JSON.stringify(data, null, 2))}</pre>`
+    return
+  }
+
+  let inner = ''
+  if (subcommand === 'brief')         inner = renderBrief(d)
+  else if (subcommand === 'map')      inner = renderMap(d)
+  else if (subcommand === 'bets')     inner = renderBets(Array.isArray(d) ? d : d.bets ?? [d])
+  else if (subcommand === 'opportunities') inner = renderOpportunities(Array.isArray(d) ? d : [])
+  else inner = `<pre style="font-size:12px;line-height:1.6;white-space:pre-wrap;color:var(--muted)">${esc(JSON.stringify(d, null, 2))}</pre>`
+
+  el.innerHTML = `<div style="padding-bottom:16px">${inner}</div>`
+}
+
+// ── Advisor ───────────────────────────────────────────────────────────────
+
+let advisorHistory = []   // { role: "user"|"ai", text, citations, confidence }
+
+function renderAdvisorHistory() {
+  const wrap = document.getElementById("advisorChat")
+  if (!advisorHistory.length) {
+    wrap.innerHTML = `<div class="empty" style="margin:0">No messages yet. Ask a question above.<small>e.g. "What decisions have been made about auth?" or "What should I tackle next?"</small></div>`
+    return
+  }
+  wrap.innerHTML = advisorHistory.map(m => {
+    if (m.role === "user") {
+      return `<div class="chat-bubble chat-bubble--user">
+        <span class="chat-label">You</span>
+        <div class="chat-body">${esc(m.text)}</div>
+      </div>`
+    }
+    const confPct = m.confidence != null ? Math.round(m.confidence * 100) : null
+    const confHtml = confPct != null ? `<div class="chat-confidence">${confPct}% confidence</div>` : ""
+    const citHtml = m.citations?.length
+      ? `<div class="chat-citations">${m.citations.map(c => `<span class="chat-citation">${esc(c)}</span>`).join("")}</div>`
+      : ""
+    const parts = []
+    if (m.what_we_know) parts.push(`<strong>What we know:</strong> ${esc(m.what_we_know)}`)
+    if (m.recommendation) parts.push(`<strong>Recommendation:</strong> ${esc(m.recommendation)}`)
+    if (m.next_step) parts.push(`<strong>Next step:</strong> ${esc(m.next_step)}`)
+    if (m.risks?.length) parts.push(`<strong>Risks:</strong> ${m.risks.map(r => esc(r)).join("; ")}`)
+    return `<div class="chat-bubble chat-bubble--ai">
+      <span class="chat-label">Advisor</span>
+      <div class="chat-body">${parts.length ? parts.join("<br>") : esc(m.text)}</div>
+      ${confHtml}${citHtml}
+    </div>`
+  }).join("")
+  wrap.scrollTop = wrap.scrollHeight
+}
+
+async function sendAdvisorMsg() {
+  const input = document.getElementById("advisorInput")
+  const question = input.value.trim()
+  if (!question) return
+  input.value = ""
+  advisorHistory.push({ role: "user", text: question })
+  renderAdvisorHistory()
+
+  // Placeholder while waiting
+  advisorHistory.push({ role: "ai", text: "Thinking…", _pending: true })
+  renderAdvisorHistory()
+
+  try {
+    const res  = await fetch("/api/advisor", { method: "POST", headers: { "content-type": "application/json" }, body: JSON.stringify({ question }) })
+    const data = await res.json()
+    // Remove placeholder
+    advisorHistory = advisorHistory.filter(m => !m._pending)
+
+    if (data.status === "no-llm") {
+      advisorHistory.push({ role: "ai", text: "No LLM provider configured. " + data.message })
+    } else if (data.error) {
+      advisorHistory.push({ role: "ai", text: "Error: " + data.error })
+    } else {
+      const citations = (data.evidence ?? []).map(e => (e.id ?? "").slice(0, 8)).filter(Boolean)
+      advisorHistory.push({
+        role: "ai",
+        what_we_know:   data.what_we_know,
+        recommendation: data.recommendation,
+        next_step:      data.next_step,
+        risks:          data.risks,
+        confidence:     data.confidence,
+        citations,
+      })
+    }
+  } catch (err) {
+    advisorHistory = advisorHistory.filter(m => !m._pending)
+    advisorHistory.push({ role: "ai", text: "Request failed: " + err.message })
+  }
+  renderAdvisorHistory()
+}
+
+// ── Check ─────────────────────────────────────────────────────────────────
+
+async function runCheck() {
+  const outcome = document.getElementById("checkOutcome").value.trim()
+  const design  = document.getElementById("checkDesign").value.trim()
+  if (!outcome && !design) { toast("Enter an outcome or design first", "err"); return }
+
+  const el = document.getElementById("checkResult")
+  el.innerHTML = `<div class="loading">Analysing…</div>`
+
+  try {
+    const res  = await fetch("/api/check", { method: "POST", headers: { "content-type": "application/json" }, body: JSON.stringify({ outcome, design }) })
+    const data = await res.json()
+    if (data.error) { el.innerHTML = `<div class="empty">Error: ${esc(data.error)}</div>`; return }
+
+    const { risk, preflight } = data
+    const level = risk?.level ?? "low"
+    const riskLabel = { critical: "Critical", high: "High", medium: "Medium", low: "Low" }[level] ?? level
+    const reasons = (risk?.reasons ?? []).filter(r => r !== "no sensitive patterns detected")
+
+    let html = `<div class="risk-banner risk-${level}">
+      <span class="risk-level">${riskLabel}</span>
+      <span style="font-size:13px">${reasons.length ? reasons.join(" · ") : "No sensitive patterns detected"}</span>
+    </div>`
+
+    html += `<div style="display:flex;flex-wrap:wrap;gap:16px">`
+
+    // Preflight flags
+    html += `<div style="min-width:200px">`
+    html += `<div class="cp-section-label" style="margin-bottom:8px">Preflight flags</div>`
+    const sensitive = preflight?.sensitive_areas ?? []
+    if (sensitive.length) {
+      html += sensitive.map(a => `<div class="preflight-row preflight-bad"><span>⚠</span> ${esc(a)}</div>`).join("")
+    } else {
+      html += `<div class="preflight-row preflight-ok"><span>✓</span> No sensitive areas</div>`
+    }
+    html += `<div class="preflight-row ${preflight?.rollback_mentioned ? "preflight-ok" : "preflight-bad"}">
+      <span>${preflight?.rollback_mentioned ? "✓" : "·"}</span> Rollback ${preflight?.rollback_mentioned ? "mentioned" : "not mentioned"}
+    </div>`
+    html += `<div class="preflight-row ${preflight?.test_strategy_mentioned ? "preflight-ok" : "preflight-bad"}">
+      <span>${preflight?.test_strategy_mentioned ? "✓" : "·"}</span> Tests ${preflight?.test_strategy_mentioned ? "mentioned" : "not mentioned"}
+    </div>`
+    html += `</div></div>`
+
+    el.innerHTML = html
+  } catch (err) {
+    el.innerHTML = `<div class="empty">Request failed: ${esc(err.message)}</div>`
+  }
+}
+
+// ── Ingest ────────────────────────────────────────────────────────────────
+
+async function runIngest(type) {
+  let body = { type }
+  let resultEl
+
+  if (type === "git") {
+    body.since   = document.getElementById("ingestGitSince").value.trim() || "P90D"
+    body.propose = document.getElementById("ingestGitPropose").checked
+    resultEl = document.getElementById("ingestGitResult")
+  } else if (type === "files") {
+    const raw = document.getElementById("ingestFilePaths").value.trim()
+    if (!raw) { toast("Enter at least one file path", "err"); return }
+    body.paths   = raw
+    body.propose = document.getElementById("ingestFilePropose").checked
+    resultEl = document.getElementById("ingestFileResult")
+  } else if (type === "url") {
+    const u = document.getElementById("ingestUrl").value.trim()
+    if (!u) { toast("Enter a URL", "err"); return }
+    body.urls    = u
+    body.propose = document.getElementById("ingestUrlPropose").checked
+    resultEl = document.getElementById("ingestUrlResult")
+  }
+
+  resultEl.textContent = "Running…"
+  try {
+    const res  = await fetch("/api/ingest", { method: "POST", headers: { "content-type": "application/json" }, body: JSON.stringify(body) })
+    const data = await res.json()
+    if (data.error) { resultEl.textContent = "Error: " + data.error; return }
+
+    let out = `✓ ${data.added} added, ${data.skipped} skipped`
+    if (body.propose && data.added > 0) out += ` — proposals staged, run quorum commit --list to review`
+    if (data.items?.length) {
+      out += "\n" + data.items.slice(0, 8).map(i => `  ${i.ref}  ${i.summary}`).join("\n")
+      if (data.items.length > 8) out += `\n  … and ${data.items.length - 8} more`
+    }
+    resultEl.textContent = out
+    if (data.added > 0) toast(`Ingested ${data.added} ${type} item${data.added !== 1 ? "s" : ""}`)
+  } catch (err) {
+    resultEl.textContent = "Request failed: " + err.message
+  }
+}
+
+// ── Sentinel ──────────────────────────────────────────────────────────────
+
+let sentinelLoaded = false
+
+async function loadSentinel() {
+  sentinelLoaded = true
+  const el = document.getElementById("sentinelView")
+  try {
+    const res  = await fetch("/api/sentinel/drift")
+    const data = await res.json()
+    renderSentinel(data)
+  } catch (err) {
+    el.innerHTML = `<div class="empty">Failed to load sentinel data<small>${esc(err.message)}</small></div>`
+  }
+}
+
+function renderSentinel(data) {
+  const el = document.getElementById("sentinelView")
+  const { total = 0, flagged = 0, flags = [], note = "" } = data
+
+  let html = `<div style="display:flex;gap:20px;margin-bottom:18px;flex-wrap:wrap">`
+  html += `<div style="text-align:center;min-width:100px"><div style="font-size:28px;font-weight:800;color:var(--text)">${total}</div><div style="font-size:12px;color:var(--muted)">Chronicle entries</div></div>`
+  html += `<div style="text-align:center;min-width:100px"><div style="font-size:28px;font-weight:800;color:${flagged > 0 ? "var(--yellow)" : "var(--green)"}">${flagged}</div><div style="font-size:12px;color:var(--muted)">Structurally drifted</div></div>`
+  html += `</div>`
+
+  if (note) html += `<p style="font-size:12px;color:var(--muted);margin-bottom:16px">${esc(note)}</p>`
+
+  if (!flags.length) {
+    html += `<div class="empty">No drift detected — all affected_areas paths resolve to existing files.</div>`
+  } else {
+    for (const f of flags) {
+      html += `<div class="drift-flag">
+        <div class="drift-flag-title">[${esc(f.entryId)}] ${esc(f.topic)}</div>
+        <div class="drift-flag-body">${esc(f.decision)}</div>
+        <div class="drift-missing">
+          ${f.missingFiles.map(p => `<span class="drift-path">${esc(p)}</span>`).join("")}
+        </div>
+      </div>`
+    }
+  }
+
+  el.innerHTML = html
 }
 </script>
 </body>

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@balpal4495/quorum",
-  "version": "3.6.0",
+  "version": "3.8.0",
   "description": "Git-backed memory and design review for AI coding agents",
   "type": "module",
   "license": "MIT",