@hir4ta/mneme 0.23.0 → 0.23.2

package/dist/servers/search-server.js

@@ -29951,15 +29951,15 @@ var StdioServerTransport = class {
   }
 };
 
-// lib/search-core.ts
+// lib/search/core.ts
 import * as fs4 from "node:fs";
 import * as path4 from "node:path";
 
-// lib/search-helpers.ts
+// lib/search/helpers.ts
 import * as fs3 from "node:fs";
 import * as path3 from "node:path";
 
-// lib/fuzzy-search.ts
+// lib/search/fuzzy.ts
 import * as fs2 from "node:fs";
 import * as path2 from "node:path";
 
@@ -29989,7 +29989,7 @@ function findJsonFiles(dir) {
   return results;
 }
 
-// lib/fuzzy-search.ts
+// lib/search/fuzzy.ts
 function levenshtein(a, b) {
   const matrix = [];
   for (let i = 0; i <= a.length; i++) {
@@ -30151,7 +30151,7 @@ function scoreDocument(doc, queries, fields) {
   }
   return totalScore;
 }
-var isMain = process.argv[1]?.endsWith("fuzzy-search.js") || process.argv[1]?.endsWith("fuzzy-search.ts");
+var isMain = process.argv[1]?.endsWith("fuzzy.js") || process.argv[1]?.endsWith("fuzzy.ts");
 if (isMain && process.argv.length > 2) {
   const args = process.argv.slice(2);
   const queryIndex = args.indexOf("--query");
@@ -30168,7 +30168,7 @@ if (isMain && process.argv.length > 2) {
   });
 }
 
-// lib/search-helpers.ts
+// lib/search/helpers.ts
 function escapeRegex2(value) {
   return value.replace(/[.*+?^${}()|[\]\\]/g, "\\$&");
 }
@@ -30229,7 +30229,7 @@ function walkJsonFiles(dir, callback) {
   }
 }
 
-// lib/search-core.ts
+// lib/search/core.ts
 function searchInteractions(keywords, projectPath, database, limit = 5) {
   if (!database) return [];
   try {
@@ -30480,7 +30480,7 @@ var server = new McpServer({
 server.registerTool(
   "mneme_search",
   {
-    description: "Search mneme's knowledge base for sessions and interactions. Returns scored results with matched fields.",
+    description: "Search mneme's knowledge base for sessions and interactions.",
     inputSchema: {
       query: external_exports3.string().max(QUERY_MAX_LENGTH).describe("Search query (keywords)"),
       types: external_exports3.array(external_exports3.enum(["session", "interaction"])).optional().describe("Types to search (default: session/interaction)."),

package/hooks/lib/common.sh

@@ -28,16 +28,26 @@ validate_mneme() {
 # Find a script: first try dist/ (production), then lib/ (development).
 # Usage: find_script <plugin_root> <name>
 # Example: find_script "$PLUGIN_ROOT" "incremental-save"
-#   → /path/to/dist/lib/incremental-save.js  or
-#   → /path/to/lib/incremental-save.ts        or
+#   → /path/to/dist/lib/save/index.js  or
+#   → /path/to/lib/save/index.ts       or
 #   → "" (not found)
 find_script() {
   local plugin_root="$1"
   local name="$2"
-  if [ -f "${plugin_root}/dist/lib/${name}.js" ]; then
-    echo "${plugin_root}/dist/lib/${name}.js"
-  elif [ -f "${plugin_root}/lib/${name}.ts" ]; then
-    echo "${plugin_root}/lib/${name}.ts"
+
+  # Map names to subdirectory paths
+  local mapped_name="$name"
+  case "$name" in
+    incremental-save)  mapped_name="save/index" ;;
+    prompt-search)     mapped_name="search/prompt" ;;
+    session-init)      mapped_name="session/init" ;;
+    session-finalize)  mapped_name="session/finalize" ;;
+  esac
+
+  if [ -f "${plugin_root}/dist/lib/${mapped_name}.js" ]; then
+    echo "${plugin_root}/dist/lib/${mapped_name}.js"
+  elif [ -f "${plugin_root}/lib/${mapped_name}.ts" ]; then
+    echo "${plugin_root}/lib/${mapped_name}.ts"
   fi
 }
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@hir4ta/mneme",
-  "version": "0.23.0",
+  "version": "0.23.2",
   "description": "Long-term memory plugin for Claude Code - automated session saving, recording technical decisions, and web dashboard",
   "keywords": [
     "claude",
@@ -27,7 +27,7 @@
     "dev:server": "tsx watch dashboard/server/index.ts",
     "build": "vite build && npm run build:server && npm run build:lib && npm run build:mcp",
     "build:server": "esbuild dashboard/server/index.ts --bundle --platform=node --outfile=dist/server.js --format=esm --external:fsevents",
-    "build:lib": "esbuild lib/*.ts --bundle --platform=node --outdir=dist/lib --format=esm --external:fsevents",
+    "build:lib": "esbuild lib/save/index.ts lib/search/prompt.ts lib/session/init.ts lib/session/finalize.ts --bundle --platform=node --outdir=dist/lib --format=esm --external:fsevents",
     "build:mcp": "esbuild servers/db-server.ts servers/search-server.ts --bundle --platform=node --outdir=dist/servers --format=esm --external:fsevents",
     "preview": "npm run build && node dist/server.js",
     "lint": "biome check .",

package/scripts/search-benchmark.ts

@@ -1,6 +1,6 @@
 import fs from "node:fs";
 import path from "node:path";
-import { type QueryableDb, searchKnowledge } from "../lib/search-core.js";
+import { type QueryableDb, searchKnowledge } from "../lib/search/core.js";
 
 // Suppress Node.js SQLite experimental warning.
 const originalEmit = process.emit;

package/servers/{db-benchmark.ts → db/benchmark.ts}

@@ -4,15 +4,15 @@
 
 import * as path from "node:path";
 
-import { searchKnowledge } from "../lib/search-core.js";
-import type { BenchmarkQuery } from "./db-types.js";
+import { searchKnowledge } from "../../lib/search/core.js";
+import type { BenchmarkQuery } from "./types.js";
 import {
   getDb,
   getMnemeDir,
   getProjectPath,
   readJsonFile,
   readRuleItems,
-} from "./db-utils.js";
+} from "./utils.js";
 
 export function runSearchBenchmark(limit: number): {
   queryCount: number;

package/servers/{db-queries.ts → db/queries.ts}

@@ -1,10 +1,5 @@
-import type {
-  Interaction,
-  ProjectInfo,
-  SessionInfo,
-  Stats,
-} from "./db-types.js";
-import { getDb } from "./db-utils.js";
+import type { Interaction, ProjectInfo, SessionInfo, Stats } from "./types.js";
+import { getDb } from "./utils.js";
 
 type SearchRow = {
   session_id: string;

package/servers/{db-save.ts → db/save.ts}

@@ -3,9 +3,9 @@
  */
 
 import * as os from "node:os";
-import { getTranscriptPath, parseTranscript } from "./db-transcript.js";
-import type { ParsedInteraction } from "./db-types.js";
-import { getDb, getProjectPath } from "./db-utils.js";
+import { getTranscriptPath, parseTranscript } from "./transcript.js";
+import type { ParsedInteraction } from "./types.js";
+import { getDb, getProjectPath } from "./utils.js";
 
 interface SaveInteractionsResult {
   success: boolean;

package/servers/{db-session-summary.ts → db/session-summary.ts}

@@ -7,10 +7,10 @@ import * as path from "node:path";
 import type { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
 import { z } from "zod";
 
-import { markSessionCommitted } from "./db-save.js";
-import { getTranscriptPath, parseTranscript } from "./db-transcript.js";
-import { fail, ok } from "./db-types.js";
-import { getProjectPath, readJsonFile } from "./db-utils.js";
+import { markSessionCommitted } from "./save.js";
+import { getTranscriptPath, parseTranscript } from "./transcript.js";
+import { fail, ok } from "./types.js";
+import { getProjectPath, readJsonFile } from "./utils.js";
 
 interface SessionSummaryParams {
   claudeSessionId: string;
@@ -182,9 +182,7 @@ export function registerSessionSummaryTool(server: McpServer) {
     "mneme_update_session_summary",
     {
       description:
-        "Update session JSON file with summary data. " +
-        "MUST be called during /mneme:save Phase 3 to persist session metadata. " +
-        "Creates the session file if it does not exist (e.g. when SessionStart hook was skipped).",
+        "Update session JSON with summary data for /mneme:save Phase 3.",
       inputSchema: {
         claudeSessionId: z
           .string()

package/servers/{db-server-tools.ts → db/tools.ts}

@@ -6,25 +6,23 @@
 import type { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
 import { z } from "zod";
 
-import { lintRules, runSearchBenchmark } from "./db-benchmark.js";
-import { getInteractions } from "./db-queries.js";
-import { markSessionCommitted } from "./db-save.js";
+import { lintRules, runSearchBenchmark } from "./benchmark.js";
+import { getInteractions } from "./queries.js";
+import { markSessionCommitted } from "./save.js";
 import {
   fail,
   LIST_LIMIT_MIN,
   ok,
   SEARCH_EVAL_DEFAULT_LIMIT,
-} from "./db-types.js";
-import { getDb, readSessionsById } from "./db-utils.js";
+} from "./types.js";
+import { getDb, readSessionsById } from "./utils.js";
 
 export function registerExtendedTools(server: McpServer) {
   server.registerTool(
     "mneme_mark_session_committed",
     {
       description:
-        "Mark a session as committed (saved with /mneme:save). " +
-        "This prevents the session's interactions from being deleted on SessionEnd. " +
-        "Call this after successfully saving session data.",
+        "Mark session as committed to prevent cleanup on SessionEnd.",
       inputSchema: {
         claudeSessionId: z
           .string()
@@ -46,8 +44,7 @@ export function registerExtendedTools(server: McpServer) {
   server.registerTool(
     "mneme_session_timeline",
     {
-      description:
-        "Build timeline for one session or a resume-chain using sessions metadata and interactions.",
+      description: "Build timeline for a session or its resume-chain.",
       inputSchema: {
         sessionId: z.string().min(1).describe("Session ID (short or full)"),
         includeChain: z
@@ -122,8 +119,7 @@ export function registerExtendedTools(server: McpServer) {
   server.registerTool(
     "mneme_rule_linter",
     {
-      description:
-        "Lint rules for schema and quality (required fields, priority, clarity, duplicates).",
+      description: "Lint rules for schema and quality.",
       inputSchema: {
         ruleType: z
           .enum(["dev-rules", "review-guidelines", "all"])
@@ -139,8 +135,7 @@ export function registerExtendedTools(server: McpServer) {
   server.registerTool(
     "mneme_search_eval",
     {
-      description:
-        "Run/compare search benchmark and emit regression summary. Intended for CI and save-time quality checks.",
+      description: "Run/compare search benchmark for quality checks.",
       inputSchema: {
         mode: z
           .enum(["run", "compare", "regression"])

package/servers/{db-transcript.ts → db/transcript.ts}

@@ -7,8 +7,8 @@ import * as os from "node:os";
 import * as path from "node:path";
 import * as readline from "node:readline";
 
-import type { ParsedInteraction, ParsedTranscript } from "./db-types.js";
-import { getProjectPath } from "./db-utils.js";
+import type { ParsedInteraction, ParsedTranscript } from "./types.js";
+import { getProjectPath } from "./utils.js";
 
 export function getTranscriptPath(claudeSessionId: string): string | null {
   const projectPath = getProjectPath();

package/servers/{db-utils.ts → db/utils.ts}

@@ -5,11 +5,7 @@
 import * as fs from "node:fs";
 import * as path from "node:path";
 
-import {
-  DatabaseSync,
-  type DatabaseSyncType,
-  type RuleDoc,
-} from "./db-types.js";
+import { DatabaseSync, type DatabaseSyncType, type RuleDoc } from "./types.js";
 
 export function getProjectPath(): string {
   return process.env.MNEME_PROJECT_PATH || process.cwd();

package/servers/db-server.ts

@@ -20,10 +20,10 @@ import {
   getStats,
   listProjects,
   listSessions,
-} from "./db-queries.js";
-import { saveInteractions } from "./db-save.js";
-import { registerExtendedTools } from "./db-server-tools.js";
-import { registerSessionSummaryTool } from "./db-session-summary.js";
+} from "./db/queries.js";
+import { saveInteractions } from "./db/save.js";
+import { registerSessionSummaryTool } from "./db/session-summary.js";
+import { registerExtendedTools } from "./db/tools.js";
 import {
   fail,
   INTERACTION_OFFSET_MIN,
@@ -31,8 +31,8 @@ import {
   LIST_LIMIT_MIN,
   ok,
   QUERY_MAX_LENGTH,
-} from "./db-types.js";
-import { getDb } from "./db-utils.js";
+} from "./db/types.js";
+import { getDb } from "./db/utils.js";
 
 const server = new McpServer({
   name: "mneme-db",
@@ -42,8 +42,7 @@ const server = new McpServer({
 server.registerTool(
   "mneme_list_projects",
   {
-    description:
-      "List all projects tracked in mneme's local database with session counts and last activity",
+    description: "List all projects with session counts and last activity",
     inputSchema: {},
   },
   async () => {
@@ -118,7 +117,7 @@ server.registerTool(
   "mneme_stats",
   {
     description:
-      "Get statistics across all projects: total counts, per-project breakdown, recent activity",
+      "Get statistics: total counts, per-project breakdown, recent activity",
     inputSchema: {},
   },
   async () => {
@@ -131,8 +130,7 @@ server.registerTool(
 server.registerTool(
   "mneme_cross_project_search",
   {
-    description:
-      "Search interactions across ALL projects (not just current). Uses FTS5 for fast full-text search.",
+    description: "Search interactions across all projects via FTS5.",
     inputSchema: {
       query: z.string().max(QUERY_MAX_LENGTH).describe("Search query"),
       limit: z
@@ -159,10 +157,7 @@ server.registerTool(
 server.registerTool(
   "mneme_save_interactions",
   {
-    description:
-      "Save conversation interactions from Claude Code transcript to SQLite. " +
-      "Use this during /mneme:save to persist the conversation history. " +
-      "Reads the transcript file directly and extracts user/assistant messages.",
+    description: "Save transcript interactions to SQLite for /mneme:save.",
     inputSchema: {
       claudeSessionId: z
         .string()

package/servers/search-server.ts

@@ -11,7 +11,7 @@ import {
   type QueryableDb,
   type SearchType,
   searchKnowledge,
-} from "../lib/search-core.js";
+} from "../lib/search/core.js";
 
 const { DatabaseSync } = await import("node:sqlite");
 type DatabaseSyncType = InstanceType<typeof DatabaseSync>;
@@ -131,8 +131,7 @@ const server = new McpServer({
 server.registerTool(
   "mneme_search",
   {
-    description:
-      "Search mneme's knowledge base for sessions and interactions. Returns scored results with matched fields.",
+    description: "Search mneme's knowledge base for sessions and interactions.",
     inputSchema: {
       query: z
         .string()

package/skills/harvest/SKILL.md

@@ -6,6 +6,7 @@ description: |
   (3) merged PRs contain operational lessons.
 argument-hint: "<PR-URL>"
 disable-model-invocation: true
+allowed-tools: Read, Write, Edit, Glob, Grep, Bash
 ---
 
 # /mneme:harvest

package/skills/report/SKILL.md

@@ -4,7 +4,9 @@ description: |
   Generate an AI-powered knowledge report from mneme session data.
   Use when: (1) sharing team progress, (2) reviewing accumulated knowledge,
   (3) generating weekly/monthly summaries for stakeholders.
-disable-model-invocation: false
+disable-model-invocation: true
+context: fork
+allowed-tools: Read, Write, Glob, Grep, AskUserQuestion
 ---
 
 # /mneme:report

package/skills/resume/SKILL.md

@@ -6,6 +6,7 @@ description: |
   (3) picking up where you left off after a break.
 argument-hint: "[session-id]"
 disable-model-invocation: true
+allowed-tools: Read, Write, Edit, Glob, mcp__mneme-db__mneme_get_interactions
 ---
 
 # /mneme:resume

package/skills/save/SKILL.md

@@ -5,6 +5,7 @@ description: |
   Use when: (1) finishing meaningful implementation work, (2) capturing reusable guidance,
   (3) before ending a long session.
 disable-model-invocation: false
+allowed-tools: Read, Write, Edit, Glob, Grep, Bash, mcp__mneme-db__mneme_save_interactions, mcp__mneme-db__mneme_update_session_summary, mcp__mneme-db__mneme_mark_session_committed, mcp__mneme-db__mneme_rule_linter, mcp__mneme-db__mneme_search_eval
 ---
 
 # /mneme:save

package/skills/search/SKILL.md

@@ -5,6 +5,7 @@ description: |
   Use when: (1) looking for past solutions, (2) recalling approved guidance,
   (3) finding related implementation context.
 argument-hint: "<query>"
+allowed-tools: mcp__mneme-search__mneme_search, mcp__mneme-search__mneme_get_session
 ---
 
 # /mneme:search