akashic-codebase-map

Akashic Context — Codebase Map

Project Structure

packages/
├── core/src/
│   ├── types.ts              <- Core interfaces: Message, MemoryConfig, MemoryChunk, Session
│   ├── index.ts              <- Main exports
│   ├── memory/
│   │   ├── manager.ts        <- MemoryManager class (orchestrates everything)
│   │   ├── storage.ts        <- MemoryStorage class (SQLite + FTS5)
│   │   ├── chunking.ts       <- chunkMarkdown() (~400 tokens, 80 overlap)
│   │   ├── hybrid.ts         <- mergeHybridResults() (70% vec + 30% keyword)
│   │   ├── manager.test.ts   <- Unit tests for MemoryManager
│   │   └── providers/
│   │       └── openai.ts     <- createOpenAIEmbeddingProvider()
│   └── utils/
│       ├── hash.ts           <- hashText(content): string
│       └── files.ts          <- listMemoryFiles(), exists(), ensureDir()
│
└── mcp-server/src/
    ├── index.ts              <- MemoryMcpServer class (4 MCP tools)
    ├── cli.ts                <- CLI entry point (env vars + args)
    └── index.test.ts         <- Unit tests for MCP server

Key Classes and Interfaces

MemoryManagerConfig (manager.ts)

interface MemoryManagerConfig {
  dataDir: string;       // Where DBs are stored
  userId: string;        // User identifier
  sessionId?: string;    // Optional session scope
  workspaceDir: string;  // Where MEMORY.md + memory/*.md live
  memory: MemoryConfig;
  vectorExtensionPath?: string;
}

StorageConfig (storage.ts)

interface StorageConfig {
  dataDir: string;
  userId: string;
  sessionId?: string;
}
// Current DB path: {dataDir}/memory_{userId}.db
// Sprint 0 target: {dataDir}/users/{userId}/memory.db

MemoryStorage constructor (storage.ts:85-92)

constructor(config: StorageConfig) {
  const sessionPart = config.sessionId ? `_${config.sessionId}` : "";
  const dbName = `memory_${config.userId}${sessionPart}.db`;
  this.dbPath = path.join(ensureDir(config.dataDir), dbName);
  // ...
}