@hiveai/mcp 0.9.5 → 0.9.6

package/dist/server.d.ts

@@ -1,6 +1,6 @@
 import { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
 import * as _hiveai_core from '@hiveai/core';
-import { HaivePaths, ConfidenceLevel, resolveProjectInfo } from '@hiveai/core';
+import { HaivePaths, ConfidenceLevel, resolveProjectInfo, readRuntimeJournalTail } from '@hiveai/core';
 import { z } from 'zod';
 
 interface HaiveContext {
@@ -611,17 +611,43 @@ declare const MemConflictCandidatesInputSchema: {
     min_jaccard: z.ZodDefault<z.ZodNumber>;
     max_pairs: z.ZodDefault<z.ZodNumber>;
     max_scan: z.ZodDefault<z.ZodNumber>;
+    max_topic_pairs: z.ZodDefault<z.ZodNumber>;
 };
 type MemConflictCandidatesInput = {
     [K in keyof typeof MemConflictCandidatesInputSchema]: z.infer<(typeof MemConflictCandidatesInputSchema)[K]>;
 };
 declare function memConflictCandidates(input: MemConflictCandidatesInput, ctx: HaiveContext): Promise<{
     pairs: _hiveai_core.ConflictCandidatePair[];
+    topic_status_pairs: _hiveai_core.TopicStatusPair[];
     scanned: number;
     truncated: boolean;
     notice: string | undefined;
 }>;
 
+declare const RuntimeJournalAppendInputSchema: {
+    message: z.ZodString;
+    kind: z.ZodDefault<z.ZodEnum<["note", "session_end", "mcp"]>>;
+    tool: z.ZodOptional<z.ZodString>;
+};
+type RuntimeJournalAppendInput = {
+    [K in keyof typeof RuntimeJournalAppendInputSchema]: z.infer<(typeof RuntimeJournalAppendInputSchema)[K]>;
+};
+declare function runtimeJournalAppend(input: RuntimeJournalAppendInput, ctx: HaiveContext): Promise<{
+    ok: true;
+    path_hint: string;
+}>;
+
+declare const RuntimeJournalTailInputSchema: {
+    limit: z.ZodDefault<z.ZodNumber>;
+};
+type RuntimeJournalTailInput = {
+    [K in keyof typeof RuntimeJournalTailInputSchema]: z.infer<(typeof RuntimeJournalTailInputSchema)[K]>;
+};
+declare function runtimeJournalTail(input: RuntimeJournalTailInput, ctx: HaiveContext): Promise<{
+    entries: Awaited<ReturnType<typeof readRuntimeJournalTail>>;
+    empty?: boolean;
+}>;
+
 declare const SERVER_NAME = "haive";
 declare const SERVER_VERSION: string;
 declare function createHaiveServer(options?: CreateContextOptions): {
@@ -644,4 +670,4 @@ declare function runHaiveMcpStdio(options: {
     root?: string;
 }): Promise<void>;
 
-export { type AntiPatternsCheckInput, type AntiPatternsCheckOutput, type BriefingOutput, type CodeMapInput, type CodeMapToolOutput, type CodeSearchInput, type CodeSearchOutput, type GetBriefingInput, type GetRecapInput, type GetRecapOutput, type MemConflictCandidatesInput, type MemConflictsInput, type MemConflictsOutput, type MemDistillInput, type MemDistillOutput, type MemRelevantToInput, type MemRelevantToOutput, type MemResolveProjectInput, type MemSuggestTopicInput, type MemTimelineInput, type PatternDetectInput, type PatternDetectOutput, type PreCommitCheckInput, type PreCommitCheckOutput, SERVER_NAME, SERVER_VERSION, type WhyThisDecisionInput, type WhyThisDecisionOutput, type WhyThisFileInput, type WhyThisFileOutput, antiPatternsCheck, codeMapTool, codeSearch, createHaiveServer, getBriefing, getRecap, memConflictCandidates, memConflicts, memDistill, memRelevantTo, memResolveProject, memSuggestTopic, memTimeline, parseMcpCliArgs, patternDetect, preCommitCheck, printHaiveMcpVersion, runHaiveMcpStdio, whyThisDecision, whyThisFile };
+export { type AntiPatternsCheckInput, type AntiPatternsCheckOutput, type BriefingOutput, type CodeMapInput, type CodeMapToolOutput, type CodeSearchInput, type CodeSearchOutput, type GetBriefingInput, type GetRecapInput, type GetRecapOutput, type MemConflictCandidatesInput, type MemConflictsInput, type MemConflictsOutput, type MemDistillInput, type MemDistillOutput, type MemRelevantToInput, type MemRelevantToOutput, type MemResolveProjectInput, type MemSuggestTopicInput, type MemTimelineInput, type PatternDetectInput, type PatternDetectOutput, type PreCommitCheckInput, type PreCommitCheckOutput, type RuntimeJournalAppendInput, type RuntimeJournalTailInput, SERVER_NAME, SERVER_VERSION, type WhyThisDecisionInput, type WhyThisDecisionOutput, type WhyThisFileInput, type WhyThisFileOutput, antiPatternsCheck, codeMapTool, codeSearch, createHaiveServer, getBriefing, getRecap, memConflictCandidates, memConflicts, memDistill, memRelevantTo, memResolveProject, memSuggestTopic, memTimeline, parseMcpCliArgs, patternDetect, preCommitCheck, printHaiveMcpVersion, runHaiveMcpStdio, runtimeJournalAppend, runtimeJournalTail, whyThisDecision, whyThisFile };

package/dist/server.js

@@ -1125,7 +1125,11 @@ import {
 import { z as z16 } from "zod";
 
 // src/session-tracker.ts
-import { appendUsageEvent, loadConfig as loadConfig2 } from "@hiveai/core";
+import {
+  appendUsageEvent,
+  appendRuntimeJournalEntry,
+  loadConfig as loadConfig2
+} from "@hiveai/core";
 import { mkdir as mkdir5, writeFile as writeFile9, rm } from "fs/promises";
 import { existsSync as existsSync16 } from "fs";
 import path7 from "path";
@@ -1198,6 +1202,14 @@ var SessionTracker = class {
         recapId = result.id;
       } catch {
       }
+      void appendRuntimeJournalEntry(this.ctx.paths, {
+        kind: "session_end",
+        message: recapId ? `auto session close | ${toolSummary} | recap:${recapId}` : `auto session close | ${toolSummary}`,
+        meta: {
+          recap_id: recapId ?? null,
+          total_tool_calls: totalCalls
+        }
+      });
       const ranPostTask = this.events.some(
         (e) => e.tool === "mem_session_end" && !e.summary?.startsWith("Auto-captured")
       );
@@ -3068,19 +3080,27 @@ function gitFileDiff(root, file, sinceDays) {
 
 // src/tools/mem-conflict-candidates.ts
 import { existsSync as existsSync27 } from "fs";
-import { findLexicalConflictPairs, loadMemoriesFromDir as loadMemoriesFromDir21 } from "@hiveai/core";
+import {
+  findLexicalConflictPairs,
+  findTopicStatusConflictPairs,
+  loadMemoriesFromDir as loadMemoriesFromDir21
+} from "@hiveai/core";
 import { z as z30 } from "zod";
 var MemConflictCandidatesInputSchema = {
   since_days: z30.number().int().positive().max(3650).default(365).describe("Only memories created since N days ago"),
   types: z30.array(z30.enum(["decision", "architecture", "convention", "gotcha"])).default(["decision", "architecture"]).describe("Memory types scanned for pairwise lexical overlap"),
   min_jaccard: z30.number().min(0).max(1).default(0.45).describe("Minimum Jaccard token similarity to surface as a candidate pair"),
   max_pairs: z30.number().int().positive().max(100).default(20).describe("Cap pairs returned"),
-  max_scan: z30.number().int().positive().max(2e3).default(500).describe("Maximum memories sampled for O(n\xB2) scan \u2014 excess dropped after chronological sort.")
+  max_scan: z30.number().int().positive().max(2e3).default(500).describe("Maximum memories sampled for O(n\xB2) scan \u2014 excess dropped after chronological sort."),
+  max_topic_pairs: z30.number().int().positive().max(100).default(20).describe(
+    "Cap for extra signal: memories sharing the same topic with validated vs rejected status."
+  )
 };
 async function memConflictCandidates(input, ctx) {
   if (!existsSync27(ctx.paths.memoriesDir)) {
     return {
       pairs: [],
+      topic_status_pairs: [],
       scanned: 0,
       truncated: false,
       notice: "No .ai/memories directory."
@@ -3094,8 +3114,9 @@ async function memConflictCandidates(input, ctx) {
     maxPairs: input.max_pairs,
     maxScan: input.max_scan
   });
-  const notice = pairs.length === 0 ? "No lexical candidate pairs \u2265 threshold \u2014 try lowering min_jaccard or widen since_days/types." : void 0;
-  return { pairs, scanned, truncated, notice };
+  const topicStatusPairs = findTopicStatusConflictPairs(all, input.max_topic_pairs);
+  const notice = pairs.length === 0 && topicStatusPairs.length === 0 ? "No lexical or topic-status candidates \u2014 widen since_days/types or lower min_jaccard." : void 0;
+  return { pairs, topic_status_pairs: topicStatusPairs, scanned, truncated, notice };
 }
 
 // src/tools/mem-resolve-project.ts
@@ -3149,13 +3170,47 @@ async function memTimeline(input, ctx) {
   return { entries, total: entries.length, notice };
 }
 
-// src/prompts/bootstrap-project.ts
+// src/tools/runtime-journal-append.ts
+import { appendRuntimeJournalEntry as appendRuntimeJournalEntry2 } from "@hiveai/core";
 import { z as z34 } from "zod";
+var RuntimeJournalAppendInputSchema = {
+  message: z34.string().min(1).describe("Short line to append to the runtime session journal"),
+  kind: z34.enum(["note", "session_end", "mcp"]).default("note"),
+  tool: z34.string().optional().describe("When kind=mcp, which tool name (optional)")
+};
+async function runtimeJournalAppend(input, ctx) {
+  await appendRuntimeJournalEntry2(ctx.paths, {
+    kind: input.kind,
+    message: input.message,
+    ...input.tool ? { tool: input.tool } : {}
+  });
+  return {
+    ok: true,
+    path_hint: `${ctx.paths.runtimeDir}/session-journal.ndjson`
+  };
+}
+
+// src/tools/runtime-journal-tail.ts
+import { readRuntimeJournalTail } from "@hiveai/core";
+import { z as z35 } from "zod";
+var RuntimeJournalTailInputSchema = {
+  limit: z35.number().int().positive().max(500).default(30).describe("Last N journal entries to return")
+};
+async function runtimeJournalTail(input, ctx) {
+  const entries = await readRuntimeJournalTail(ctx.paths, input.limit);
+  if (entries.length === 0) {
+    return { entries: [], empty: true };
+  }
+  return { entries };
+}
+
+// src/prompts/bootstrap-project.ts
+import { z as z36 } from "zod";
 var BootstrapProjectArgsSchema = {
-  module: z34.string().optional().describe(
+  module: z36.string().optional().describe(
     "Optional module name to scope the analysis to (writes to .ai/modules/<module>/context.md)"
   ),
-  focus: z34.string().optional().describe("Optional area to emphasize (e.g. 'data layer', 'API surface')")
+  focus: z36.string().optional().describe("Optional area to emphasize (e.g. 'data layer', 'API surface')")
 };
 var ROOT_TEMPLATE = `# Project context
 
@@ -3237,10 +3292,10 @@ ${template}\`\`\`
 }
 
 // src/prompts/post-task.ts
-import { z as z35 } from "zod";
+import { z as z37 } from "zod";
 var PostTaskArgsSchema = {
-  task_summary: z35.string().optional().describe("One sentence describing what you just did"),
-  files_touched: z35.array(z35.string()).optional().describe("Files you created or modified during the task")
+  task_summary: z37.string().optional().describe("One sentence describing what you just did"),
+  files_touched: z37.array(z37.string()).optional().describe("Files you created or modified during the task")
 };
 function postTaskPrompt(args, ctx) {
   const taskLine = args.task_summary ? `
@@ -3324,12 +3379,12 @@ When done, respond with a brief summary: "Saved N memories: [list of IDs]. Sessi
 }
 
 // src/prompts/import-docs.ts
-import { z as z36 } from "zod";
+import { z as z38 } from "zod";
 var ImportDocsArgsSchema = {
-  content: z36.string().describe("The documentation content to analyze and import as memories (Markdown, README, ADR, etc.)"),
-  source: z36.string().optional().describe("Origin of the content (file path, URL, or document title) \u2014 used to anchor memories"),
-  scope: z36.enum(["personal", "team"]).default("team").describe("Scope to assign to created memories"),
-  dry_run: z36.boolean().default(false).describe("If true, describe what would be saved without actually calling mem_save")
+  content: z38.string().describe("The documentation content to analyze and import as memories (Markdown, README, ADR, etc.)"),
+  source: z38.string().optional().describe("Origin of the content (file path, URL, or document title) \u2014 used to anchor memories"),
+  scope: z38.enum(["personal", "team"]).default("team").describe("Scope to assign to created memories"),
+  dry_run: z38.boolean().default(false).describe("If true, describe what would be saved without actually calling mem_save")
 };
 function importDocsPrompt(args, ctx) {
   const sourceLine = args.source ? `
@@ -3394,7 +3449,7 @@ When done, respond with: "Imported N memories: [list of IDs]" or "Nothing action
 
 // src/server.ts
 var SERVER_NAME = "haive";
-var SERVER_VERSION = "0.9.5";
+var SERVER_VERSION = "0.9.6";
 function jsonResult(data) {
   return {
     content: [
@@ -4077,14 +4132,17 @@ function createHaiveServer(options = {}) {
   server.tool(
     "mem_conflict_candidates",
     [
-      "Bulk lexical scan for decision/architecture-like pairs that look similar (Jaccard on tokens).",
+      "Bulk scan for conflict CANDIDATES (not proof):",
       "",
-      "Advisory only \u2014 follow with mem_conflicts_with on specific ids for real contradiction checks.",
+      "  1. Lexical similarity (Jaccard) on decision/architecture-like pairs",
+      "  2. Same frontmatter.topic with validated vs rejected \u2014 quick human-review signal",
+      "",
+      "Advisory only \u2014 follow with mem_conflicts_with on specific ids.",
       "",
       "PARAMETERS:",
-      "  since_days, types, min_jaccard, max_pairs, max_scan",
+      "  since_days, types, min_jaccard, max_pairs, max_scan, max_topic_pairs",
       "",
-      "RETURNS: { pairs: [{ id_a, id_b, jaccard }], scanned, truncated, notice? }"
+      "RETURNS: { pairs, topic_status_pairs, scanned, truncated, notice? }"
     ].join("\n"),
     MemConflictCandidatesInputSchema,
     async (input) => {
@@ -4092,6 +4150,32 @@ function createHaiveServer(options = {}) {
       return jsonResult(await memConflictCandidates(input, context));
     }
   );
+  server.tool(
+    "runtime_journal_append",
+    [
+      "Append one line to `.ai/.runtime/session-journal.ndjson` \u2014 machine-local session continuity.",
+      "",
+      "Does NOT replace team memories; complements mem_session_end recaps for local traces.",
+      "",
+      "PARAMETERS: message, kind (note|session_end|mcp), optional tool",
+      "",
+      "RETURNS: { ok, path_hint }"
+    ].join("\n"),
+    RuntimeJournalAppendInputSchema,
+    async (input) => jsonResult(await runtimeJournalAppend(input, context))
+  );
+  server.tool(
+    "runtime_journal_tail",
+    [
+      "Read the last N entries from the runtime session journal (parsed JSON lines).",
+      "",
+      "PARAMETERS: limit (default 30, max 500)",
+      "",
+      "RETURNS: { entries: [...], empty?: true }"
+    ].join("\n"),
+    RuntimeJournalTailInputSchema,
+    async (input) => jsonResult(await runtimeJournalTail(input, context))
+  );
   server.tool(
     "pre_commit_check",
     [
@@ -4250,6 +4334,8 @@ export {
   preCommitCheck,
   printHaiveMcpVersion,
   runHaiveMcpStdio,
+  runtimeJournalAppend,
+  runtimeJournalTail,
   whyThisDecision,
   whyThisFile
 };