tsunami-memory 1.0.0 → 1.0.2

package/README.md

@@ -162,14 +162,14 @@ Memories don't exist in isolation — they form a graph. Every memory can be lin
 </div>
 
 ```bash
-bun install
+bun add tsunami-memory
 ```
 
 ```typescript
 import {
   tsunamiAdd, tsunamiSearch,
   buildTsunamiStormCenter, formatTsunamiStormCenterText,
-} from './src/index.ts';
+} from 'tsunami-memory';
 
 // Store a memory
 const id = await tsunamiAdd('project', 'tasks', 'Completed API refactor', 5);
@@ -383,7 +383,7 @@ import {
   buildTsunamiStormCenter, formatTsunamiStormCenterText,
   buildTsunamiExecutionGate, applyTsunamiExecutionGateToTool,
   classifyMemory,
-} from './src/index.ts';
+} from 'tsunami-memory';
 
 const id   = await tsunamiAdd('project', 'tasks', 'Completed API refactor', 5);
 const hits = await tsunamiSearch('refactor', 'project', undefined, 10);

package/README.zh-CN.md

@@ -162,14 +162,14 @@ graph TD
 </div>
 
 ```bash
-bun install
+bun add tsunami-memory
 ```
 
 ```typescript
 import {
   tsunamiAdd, tsunamiSearch,
   buildTsunamiStormCenter, formatTsunamiStormCenterText,
-} from './src/index.ts';
+} from 'tsunami-memory';
 
 // 存储记忆
 const id = await tsunamiAdd('project', 'tasks', '完成了认证模块的 API 重构', 5);
@@ -379,7 +379,7 @@ import {
   buildTsunamiStormCenter, formatTsunamiStormCenterText,
   buildTsunamiExecutionGate, applyTsunamiExecutionGateToTool,
   classifyMemory,
-} from './src/index.ts';
+} from 'tsunami-memory';
 
 const id   = await tsunamiAdd('project', 'tasks', '完成认证模块重构', 5);
 const hits = await tsunamiSearch('重构', 'project', undefined, 10);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "tsunami-memory",
-  "version": "1.0.0",
+  "version": "1.0.2",
   "description": "TSUNAMI — Bun-native oceanic memory system with basin/current flow, storm center, hot+cold retrieval, knowledge graph sync, and evidence linking.",
   "main": "src/index.ts",
   "files": [
@@ -10,10 +10,10 @@
   ],
   "repository": {
     "type": "git",
-    "url": "git+https://github.com/tsunami-memory/tsunami.git"
+    "url": "git+https://github.com/lilShawtty-byte/Tsunami-Memory.git"
   },
   "bugs": {
-    "url": "https://github.com/tsunami-memory/tsunami/issues"
+    "url": "https://github.com/lilShawtty-byte/Tsunami-Memory/issues"
   },
   "type": "module",
   "scripts": {

package/src/bun_memory_store.ts

@@ -5,36 +5,10 @@
  * and content fingerprinting for deduplication. Schema managed by migration runner.
  */
 
-import { Database } from 'bun:sqlite';
-import { existsSync, mkdirSync } from 'fs';
-import { dirname } from 'path';
+import { getDb } from './db';
 import { BUN_MEMORY_DB_PATH } from './tsunami_storage_paths';
-import { runMigrations, getMigrations } from './migration';
 export { BUN_MEMORY_DB_PATH };
 
-// ── Database initialization ──────────────────────────────────
-
-function ensureDbDir(): void {
-  const dir = dirname(BUN_MEMORY_DB_PATH);
-  if (!existsSync(dir)) mkdirSync(dir, { recursive: true });
-}
-
-let _db: Database | null = null;
-
-function getDb(): Database {
-  if (_db) return _db;
-  ensureDbDir();
-  _db = new Database(BUN_MEMORY_DB_PATH);
-  _db.run('PRAGMA journal_mode = WAL');
-  const applied = runMigrations(_db, getMigrations());
-  if (applied > 0) {
-    // First-run or upgrade — log for observability
-    const v = (_db.prepare('SELECT MAX(version) as v FROM schema_version').get() as any)?.v ?? 0;
-    console.log(`[TSUNAMI] migrations applied: ${applied}, now at v${v}`);
-  }
-  return _db;
-}
-
 // ── ID Generation ────────────────────────────────────────────
 
 function generateId(): string {

package/src/db.ts

@@ -0,0 +1,41 @@
+/**
+ * TSUNAMI shared database connection.
+ *
+ * Single WAL-mode SQLite connection shared by all modules.
+ * Schema is managed by the migration runner.
+ */
+
+import { Database } from 'bun:sqlite';
+import { existsSync, mkdirSync } from 'node:fs';
+import { dirname } from 'node:path';
+import { BUN_MEMORY_DB_PATH } from './tsunami_storage_paths';
+import { runMigrations, getMigrations } from './migration';
+
+let _db: Database | null = null;
+
+/** Get or create the shared database connection. Thread-safe via module-level singleton. */
+export function getDb(): Database {
+  if (_db) return _db;
+
+  const dir = dirname(BUN_MEMORY_DB_PATH);
+  if (!existsSync(dir)) mkdirSync(dir, { recursive: true });
+
+  _db = new Database(BUN_MEMORY_DB_PATH);
+  _db.run('PRAGMA journal_mode = WAL');
+
+  const applied = runMigrations(_db, getMigrations());
+  if (applied > 0) {
+    const v = (_db.prepare('SELECT MAX(version) as v FROM schema_version').get() as any)?.v ?? 0;
+    console.log(`[TSUNAMI] migrations applied: ${applied}, now at v${v}`);
+  }
+
+  return _db;
+}
+
+/** Close the database connection. Mainly useful in tests. */
+export function closeDb(): void {
+  if (_db) {
+    _db.close();
+    _db = null;
+  }
+}

package/src/storm/basins.ts

@@ -1,5 +1,6 @@
 // Storm center — supporting basin analysis
 import { classifyTsunamiText } from '../tsunami_classifier';
+import type { DurableRecoveryRecord } from '../runtime/checkpoints/durable_recovery';
 import type { TsunamiStormCenter } from './types';
 
 export function buildSupportingBasins(input: {

package/src/storm/boundary.ts

@@ -1,4 +1,5 @@
 import type { TsunamiStormPressure, TsunamiStormReadiness, TsunamiStormCenterStormMode, TsunamiStormBoundary } from './types';
+import type { TsunamiStormCenter } from './types';
 
 export function buildStormBoundary(input: {
   stormPressure?: TsunamiStormPressure;

package/src/storm/directive.ts

@@ -1,4 +1,5 @@
 import type { TsunamiStormPressure, TsunamiStormCenterStormMode, TsunamiStormDirective, TsunamiStormAction } from './types';
+import type { TsunamiStormCenter } from './types';
 
 export function buildStormDirective(input: {
   stormPressure?: TsunamiStormPressure;

package/src/storm/helpers.ts

@@ -4,7 +4,14 @@ import { basename, join } from 'node:path';
 import { listProjectWikiPages } from '../core/project_state';
 import type { ProjectHandoffRecord, ProjectTaskThread } from '../core/project_state';
 import type { DurableRecoveryRecord } from '../runtime/checkpoints/durable_recovery';
-import type { TsunamiStormCenterCurrent } from './types';
+import type { TsunamiStormCenterCurrent, TsunamiStormCenter } from './types';
+
+type TsunamiFallbackDocSupport = {
+  anchors: TsunamiStormCenter['anchors'];
+  evidence: TsunamiStormCenter['evidence'];
+  mainlineTitle?: string;
+  mainlineSummary?: string;
+};
 
 const TSUNAMI_STORM_RETRY_DELAYS_MS = [8, 18, 36] as const;
 

package/src/storm/horizon.ts

@@ -1,4 +1,5 @@
 import type { TsunamiStormPressure, TsunamiStormReadiness, TsunamiStormBoundary, TsunamiStormCenterStormMode, TsunamiStormHorizon } from './types';
+import type { TsunamiStormCenter } from './types';
 
 export function buildStormHorizon(input: {
   stormPressure?: TsunamiStormPressure;

package/src/storm/pressure.ts

@@ -1,4 +1,6 @@
 import type { TsunamiStormCenterCurrentMix, TsunamiStormCenterStormMode, TsunamiStormPressure } from './types';
+import type { TsunamiStormCenter } from './types';
+import type { DurableRecoveryRecord } from '../runtime/checkpoints/durable_recovery';
 
 export function buildStormPressure(input: {
   currentMix: TsunamiStormCenterCurrentMix[];

package/src/storm/readiness.ts

@@ -1,4 +1,5 @@
-import type { TsunamiStormReadiness } from './types';
+import type { DurableRecoveryRecord } from '../runtime/checkpoints/durable_recovery';
+import type { TsunamiStormReadiness, TsunamiStormCenter } from './types';
 
 export function buildStormReadiness(input: {
   hasMainline: boolean;

package/src/storm/signals.ts

@@ -1,5 +1,7 @@
 // Storm center — signal analysis
 import { clampEnergy, safeTrim, buildProjectNode, buildTaskThreadNode, buildHandoffNode, buildAnchorNode, buildRecoveryNode } from './helpers';
+import type { ProjectTaskThread, ProjectHandoffRecord } from '../core/project_state';
+import type { DurableRecoveryRecord } from '../runtime/checkpoints/durable_recovery';
 import type { StormCurrentKind, TsunamiStormCenterCurrent, TsunamiStormCenterCurrentMix, TsunamiStormCenter } from './types';
 
 export function buildCurrents(input: {

package/src/storm/types.ts

@@ -3,6 +3,12 @@ import type { ProjectHandoffRecord, ProjectTaskThread } from '../core/project_st
 import type { DurableRecoveryRecord } from '../runtime/checkpoints/durable_recovery';
 import type { TsunamiRuntimeGraphSyncSummary } from '../tsunami_runtime_graph_sync';
 
+// Forward-declare return types used in TsunamiStormCenter — these are stubs
+// since the real implementations live in stub modules; this keeps types.ts clean.
+type WikiEvidenceSnippet = { snippetId: string; pageId: string; title: string; sourcePath?: string; sourceRef?: string; quote: string; tags: string[] };
+type MemoryIssue = { code: string; severity?: string; detail?: string };
+type MemoryRepairSuggestion = { title: string; priority?: string; detail?: string };
+
 export type BuildStormCenterOpts = {
   projectDir?: string;
   query?: string;
@@ -13,7 +19,7 @@ export type BuildStormCenterOpts = {
   relationLimit?: number;
 };
 
-type StormCurrentKind =
+export type StormCurrentKind =
   | 'primary_thread'
   | 'handoff'
   | 'anchor'
@@ -169,7 +175,7 @@ export type TsunamiStormCenter = {
     confidence: number;
     tags: string[];
   }>;
-  evidence: ReturnType<typeof queryProjectWiki>['evidence'];
+  evidence: WikiEvidenceSnippet[];
   graph: {
     project: Record<string, unknown>[];
     thread: Record<string, unknown>[];
@@ -177,8 +183,8 @@ export type TsunamiStormCenter = {
     anchor: Record<string, unknown>[];
     recovery: Record<string, unknown>[];
   };
-  issues: ReturnType<typeof auditMemoryFabric>['issues'];
-  repairSuggestions: ReturnType<typeof auditMemoryFabric>['repairSuggestions'];
+  issues: MemoryIssue[];
+  repairSuggestions: MemoryRepairSuggestion[];
   currents: TsunamiStormCenterCurrent[];
   currentMix: TsunamiStormCenterCurrentMix[];
   stormMode?: TsunamiStormCenterStormMode;

package/src/tsunami_graph_runtime.ts

@@ -6,21 +6,7 @@
  * BFS traversal, and cross-wing tunnel discovery.
  */
 
-import { Database } from 'bun:sqlite';
-import { BUN_MEMORY_DB_PATH } from './tsunami_storage_paths';
-import { runMigrations, getMigrations } from './migration';
-
-// ── Database initialization ──────────────────────────────────
-
-let _db: Database | null = null;
-
-function getDb(): Database {
-  if (_db) return _db;
-  _db = new Database(BUN_MEMORY_DB_PATH);
-  _db.run('PRAGMA journal_mode = WAL');
-  runMigrations(_db, getMigrations()); // idempotent — applies only pending
-  return _db;
-}
+import { getDb } from './db';
 
 // ── ID Generation ────────────────────────────────────────────