n2-soul 8.0.0 → 9.0.0

package/CHANGELOG.md

@@ -0,0 +1,103 @@
+# Changelog
+
+All notable changes to Soul are documented here.
+
+## [9.0.0] — 2026-03-26
+
+### 🔒 Strict TypeScript Migration
+
+Soul is now fully written in **TypeScript strict mode** with zero `any` usage.
+
+#### Added
+- **ESLint strict rules** — automated detection of floating promises, unused vars, type safety violations
+- **30 unit tests** — utils, soul-engine, kv-cache, and dispose pattern verification
+- **`npm run verify`** — one-command pipeline: typecheck + lint + build + test
+- **`SoulKVCache.dispose()`** — proper timer cleanup for backup scheduler
+- **`disposeWorkSequence()`** — GC timer cleanup for test environments
+- **HTTP response size limit** (10MB) for Ollama embedding requests
+- **`sql-js.d.ts`** — custom type declarations for sql.js WASM module
+
+#### Fixed
+- **CRITICAL**: `stmt.free()` / `embStmt.free()` now wrapped in `try/finally` blocks (WASM memory leak prevention)
+- **CRITICAL**: `.catch(() => {})` silent error swallowing replaced with `logError()` 
+- **HIGH**: Floating promise in auto-backup timer — added `void` + `.catch()` error handling
+- **HIGH**: `Buffer` + `string` concatenation — explicit `.toString()` conversion
+
+#### Changed
+- Source code migrated from CommonJS to `import/export` (ESM-style), compiled output remains CJS for compatibility
+- 13 `require()` calls → 9 static `import` + 4 documented lazy `require()` (circular deps, runtime optional)
+- `export =` → `export default` for ESM/CJS interop
+- `tsconfig.json` — `strict: true`, `noUncheckedIndexedAccess`, `noUnusedLocals`, `noUnusedParameters`
+
+#### Dependencies Added (devDependencies)
+- `eslint` ^9.x
+- `@eslint/js` ^9.x
+- `typescript-eslint` ^8.x
+
+---
+
+## [8.0.0] — 2026-03-26
+
+### 🧠 Forgetting Curve — Intelligent Memory
+
+Soul now remembers what matters and forgets what doesn't, inspired by Ebbinghaus' forgetting curve.
+
+#### Added
+- **Forgetting Curve GC** — retention formula: `importance × (1 + log₂(1 + accessCount)) × e^(−λ × ageDays)`
+- **3-tier memory lifecycle** — Hot (0–7d, in-memory + disk) → Warm (8–30d, disk) → Cold (30d+, archived)
+- **Async I/O** — all hot-path operations non-blocking (42% faster KV load, 3x+ search throughput)
+- **Schema v2** — `accessCount`, `lastAccessed`, `importance`, `tier` fields (auto-migrated from v1)
+- **SQLite backend** — `sql.js` WASM-based, no native bindings needed
+- **Incremental backups** — portable SQLite backup/restore with configurable retention
+- **Semantic search** — Ollama `nomic-embed-text` embedding integration
+
+#### Changed
+- SDK Native Migration — removed legacy `registerTool` shim, direct `server.tool()` API
+- `z.any()` eliminated from all tool schema definitions
+
+---
+
+## [7.0.0] — 2026-03
+
+### 🕸️ Arachne — Code Context Assembly
+
+> **Note**: Arachne has been separated into its own package [`n2-arachne`](https://github.com/choihyunsus/n2-arachne) as of v8.0.
+
+- BM25 search + dependency tracking + smart assembly
+- 50,000 file project → 30 most relevant chunks → 30K tokens (instead of 500K+)
+- Ollama semantic search support
+
+---
+
+## [6.0.0] — 2026-03
+
+### 🛡️ Ark — AI Safety System
+
+> **Note**: Ark has been separated into its own package [`n2-ark`](https://github.com/choihyunsus/n2-ark) as of v8.0.
+
+- Zero-token-cost safety enforcement via regex pattern matching
+- Multi-layer response system (WARN → MODIFY → BLOCK → LOCKDOWN)
+- `.n2` rule file format with 7 domain templates
+- Full MCP compatibility
+
+---
+
+## [5.0.0] — 2026-02
+
+### 🏷️ Entity & Core Memory
+
+- **Entity Memory** — auto-track people, hardware, projects, concepts
+- **Core Memory** — per-agent always-loaded facts
+- **Auto-extraction** — entities and insights saved automatically at `n2_work_end`
+- **Context Search** — keyword search across Brain + Ledger
+
+---
+
+## [4.0.0] — 2026-01
+
+### 📋 Soul Board & Ledger
+
+- **Soul Board** — project state + TODO tracking + cross-agent handoff
+- **Immutable Ledger** — append-only work logs with date-based partitioning
+- **File Ownership** — collision prevention for multi-agent environments
+- **Shared Brain** — file-based shared memory with path traversal protection

package/README.ko.md

@@ -3,18 +3,6 @@
 # 🧠 Soul
 
 **AI 에이전트는 세션이 끝나면 모든 걸 잊어버립니다. Soul이 그걸 해결합니다.**
-**AI 에이전트가 위험한 행동을 할 수도 있습니다. Ark가 그걸 막습니다.**
-**AI 에이전트가 관련 없는 코드를 읽느라 토큰을 낭비합니다. Arachne가 그걸 해결합니다.**
-
-> ### 🚀 v7.0 업데이트 — Arachne
->
-> **Arachne** — 코드 컨텍스트 어셈블리 엔진. 코드베이스 전체를 인덱싱하고 AI에게 **정확히** 필요한 것만 전달합니다.
-> ```
-> 50,000 파일 프로젝트 → 가장 관련 있는 30개 청크 → 30K 토큰 (500K+ 대신)
-> ```
-> BM25 검색 + 의존성 추적 + 스마트 어셈블리. Ollama를 통한 시맨틱 검색도 지원. [자세히 →](#arachne--최고의-직조사)
->
-> **Ark** (v6.0) 포함 — 토큰 비용 0으로 위험한 행동을 차단하는 AI 안전 시스템. [자세히 →](#ark--최후의-방패)
 
 Cursor, VS Code Copilot 등 MCP 호환 AI 에이전트와 새 채팅을 시작할 때마다, 에이전트는 이전에 뭘 했는지 전혀 모른 채 처음부터 시작합니다. Soul은 에이전트에게 이런 능력을 부여하는 MCP 서버입니다:
 
@@ -22,12 +10,37 @@ Cursor, VS Code Copilot 등 MCP 호환 AI 에이전트와 새 채팅을 시작
 - 🤝 **인수인계** — 한 에이전트가 다른 에이전트의 작업을 이어받을 수 있습니다
 - 📝 **작업 이력** — 모든 작업이 변경 불가능한 로그로 기록됩니다
 - 🗂️ **공유 두뇌** — 여러 에이전트가 같은 컨텍스트를 읽고 쓸 수 있습니다
-- 🏷️ **엔티티 메모리** — 인물, 하드웨어, 프로젝트를 자동 추적합니다 (v5.0)
-- 💡 **코어 메모리** — 에이전트별 핵심 사실이 항상 로드됩니다 (v5.0)
-- 🛡️ **Ark** — 토큰 비용 0으로 위험한 행동을 차단하는 AI 안전 시스템 (v6.0)
-- 🕸️ **Arachne** — AI에게 정확히 필요한 코드만 전달하는 코드 컨텍스트 엔진 (v7.0)
+- 🏷️ **엔티티 메모리** — 인물, 하드웨어, 프로젝트를 자동 추적합니다
+- 💡 **코어 메모리** — 에이전트별 핵심 사실이 항상 로드됩니다
 
-> ⚡ **Soul은 N2 Browser의 작은 부속품 하나입니다** — 우리가 만들고 있는 AI 네이티브 브라우저의 일부예요. 멀티 에이전트 오케스트레이션, 실시간 도구 라우팅, 에이전트 간 통신 등 훨씬 더 많은 기능들이 현재 테스트 중입니다. 이건 시작에 불과합니다.
+> 🔌 **N2 에코시스템과 연동:**
+> [**Ark**](https://github.com/choihyunsus/n2-ark) (AI 안전) · [**Arachne**](https://github.com/choihyunsus/n2-arachne) (코드 컨텍스트) · [**QLN**](https://github.com/choihyunsus/n2-QLN) (도구 라우팅)
+
+## v9.0의 새로운 기능
+
+> **Strict TypeScript — `any` 제로, 메모리 누수 제로, 자동화된 품질 검증.**
+
+### 🔒 TypeScript Strict 모드 전환
+
+- 소스 코드 전체를 TypeScript `strict: true`로 마이그레이션
+- **`any` 사용 제로** — 모든 타입이 명시적이고 검증 가능
+- ESLint `strictTypeChecked` 규칙으로 floating promise, 타입 안전 위반 자동 탐지
+- 30개 단위 테스트 + `npm run verify` 원커맨드 검증 파이프라인
+
+### 🛡️ 보안 & 메모리 감사
+
+- WASM 메모리 누수 수정 — `stmt.free()` → `try/finally` 블록
+- 무음 에러 삼킴 제거 — 모든 `.catch()` 핸들러가 에러 로깅
+- 임베딩 요청 HTTP 응답 크기 제한 (10MB)
+- `dispose()` 메서드로 타이머 누수 방지
+
+### 🧠 v8.0 기능 (포함)
+
+- **망각 곡선 GC** — 접근 패턴 기반 지능형 기억 보존
+- **비동기 I/O** — 논블로킹 연산, KV 로드 42% 빨라짐
+- **3단계 메모리** — Hot → Warm → Cold 수명 주기
+
+> 전체 버전 히스토리는 [CHANGELOG.md](CHANGELOG.md)를 참고하세요.
 
 ## 빠른 시작
 

package/README.md

@@ -6,7 +6,7 @@
 [![License](https://img.shields.io/badge/license-Apache--2.0-blue.svg)](LICENSE)
 [![Node](https://img.shields.io/badge/node-%3E%3D18-brightgreen.svg)](https://nodejs.org)
 [![npm downloads](https://img.shields.io/npm/dm/n2-soul.svg)](https://www.npmjs.com/package/n2-soul)
-[![v8.0.0](https://img.shields.io/badge/v8.0.0-Forgetting%20Curve-blueviolet.svg)](#whats-new-in-v80)
+[![v9.0.0](https://img.shields.io/badge/v9.0.0-Strict%20TypeScript-blueviolet.svg)](#whats-new-in-v90)
 
 **Your AI agent forgets everything when a session ends. Soul fixes that.**
 
@@ -26,73 +26,41 @@ Every time you start a new chat with Cursor, VS Code Copilot, or any MCP-compati
 
 ## Table of Contents
 
-- [What's New in v8.0](#whats-new-in-v80)
+- [What's New in v9.0](#whats-new-in-v90)
 - [Quick Start](#quick-start)
 - [Why Soul?](#why-soul)
-- [Token Efficiency](#token-efficiency)
-- [How It Works](#how-it-works)
 - [Features](#features)
 - [Cloud Storage](#️-cloud-storage--store-your-ai-memory-anywhere)
 - [Available Tools](#available-tools)
-- [Real-World Example](#real-world-example)
-- [Rust Compiler (n2c)](#rust-compiler-n2c)
 - [Configuration](#configuration)
-- [N2 Ecosystem](#-n2-ecosystem)
 - [Contributing](#contributing)
-- [Sponsors](#-sponsors)
+- [Changelog](CHANGELOG.md)
 
-## What's New in v8.0
+## What's New in v9.0
 
-> **Forgetting Curve — Soul now remembers what matters and forgets what doesn't.**
+> **Strict TypeScript — Zero `any`, zero memory leaks, automated quality enforcement.**
 
-### 🧠 Intelligent Memory (Forgetting Curve GC)
+### 🔒 Full TypeScript Strict Mode
 
-Inspired by Ebbinghaus' forgetting curve, Soul v8.0 intelligently manages memory retention:
+- Source code migrated to TypeScript with `strict: true`
+- **Zero `any`** — every type is explicit and verifiable
+- ESLint `strictTypeChecked` rules catch floating promises, type safety violations
+- 30 unit tests with `npm run verify` one-command pipeline
 
-```
-retention = importance × (1 + log₂(1 + accessCount)) × e^(−λ × ageDays)
-```
-
-- **Frequently accessed** sessions are kept longer
-- **Important** snapshots resist decay
-- **Stale** memory is automatically pruned via 3-tier lifecycle:
-
-| Tier | Age | Storage |
-|------|-----|--------|
-| 🔴 Hot | 0–7 days | In-memory cache + disk |
-| 🟡 Warm | 8–30 days | Disk only |
-| 🔵 Cold | 30+ days | Archived (compressed) |
-
-### ⚡ Performance Revolution — Async I/O
-
-All hot-path I/O operations are now fully asynchronous:
+### 🛡️ Security & Memory Audit
 
-| Operation | v7 (sync) | v8 (async) | Improvement |
-|-----------|-----------|------------|-------------|
-| KV Save | Blocks event loop | Non-blocking | ∞ (no block) |
-| KV Load | 1.2ms (blocking) | 0.7ms (async) | 42% faster |
-| KV Search | Blocks | Parallel | 3x+ throughput |
-| GC | Blocks during sweep | Background | Non-disruptive |
+- WASM memory leak fix — `stmt.free()` wrapped in `try/finally`
+- Silent error swallowing eliminated — all `.catch()` handlers log errors
+- HTTP response size limits for embedding requests
+- `dispose()` methods for proper timer cleanup
 
-### 🔧 SDK Native Migration
+### 🧠 v8.0 Features (Included)
 
-- Removed legacy `registerTool` shim → direct `server.tool()` API
-- Strict schema validation: `z.any()` eliminated from all tool definitions
-- Full MCP SDK v1.6.1 compatibility
+- **Forgetting Curve GC** — intelligent memory retention based on access patterns
+- **Async I/O** — non-blocking operations, 42% faster KV load
+- **3-tier memory** — Hot → Warm → Cold lifecycle
 
-### 📦 Schema v2 (Backward Compatible)
-
-Snapshots now include Forgetting Curve metadata. Existing v1 snapshots are **auto-migrated** on first load:
-
-```diff
-+ accessCount: 0        // How often this snapshot was accessed
-+ lastAccessed: null     // When it was last loaded
-+ importance: 0.5        // 0.0–1.0 importance score
-+ tier: 'warm'           // hot / warm / cold
-```
-
-> [!NOTE]
-> **Upgrading from v7.x**: Zero breaking changes. All existing data works as-is. Snapshots are transparently migrated to schema v2 on first access.
+> See [CHANGELOG.md](CHANGELOG.md) for full version history.
 
 ---
 

package/dist/index.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/index.js

@@ -0,0 +1,33 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+// Soul MCP v9.0 — Entry point. Multi-agent session orchestrator with KV-Cache.
+const mcp_js_1 = require("@modelcontextprotocol/sdk/server/mcp.js");
+const stdio_js_1 = require("@modelcontextprotocol/sdk/server/stdio.js");
+const zod_1 = require("zod");
+const config_1 = __importDefault(require("./lib/config"));
+const boot_1 = require("./sequences/boot");
+const work_1 = require("./sequences/work");
+const end_1 = require("./sequences/end");
+const brain_1 = require("./tools/brain");
+const kv_cache_1 = require("./tools/kv-cache");
+const package_json_1 = __importDefault(require("../package.json"));
+const server = new mcp_js_1.McpServer({ name: 'n2-soul', version: package_json_1.default.version });
+// Register core modules
+(0, boot_1.registerBootSequence)(server, zod_1.z, config_1.default);
+(0, work_1.registerWorkSequence)(server, zod_1.z, config_1.default);
+(0, end_1.registerEndSequence)(server, zod_1.z, config_1.default);
+(0, brain_1.registerBrainTools)(server, zod_1.z, config_1.default);
+(0, kv_cache_1.registerKVCacheTools)(server, zod_1.z, config_1.default);
+// Start MCP transport
+async function boot() {
+    const transport = new stdio_js_1.StdioServerTransport();
+    await server.connect(transport);
+}
+boot().catch((err) => {
+    console.error(`[n2-soul] Fatal: ${err.message}`);
+    process.exit(1);
+});
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";;;;;AAAA,+EAA+E;AAC/E,oEAAoE;AACpE,wEAAiF;AACjF,6BAAwB;AAExB,0DAAkC;AAClC,2CAAwD;AACxD,2CAAwD;AACxD,yCAAsD;AACtD,yCAAmD;AACnD,+CAAwD;AAExD,mEAAkC;AAElC,MAAM,MAAM,GAAG,IAAI,kBAAS,CAAC,EAAE,IAAI,EAAE,SAAS,EAAE,OAAO,EAAE,sBAAG,CAAC,OAAO,EAAE,CAAkF,CAAC;AAEzJ,wBAAwB;AACxB,IAAA,2BAAoB,EAAC,MAAM,EAAE,OAAC,EAAE,gBAAM,CAAC,CAAC;AACxC,IAAA,2BAAoB,EAAC,MAAM,EAAE,OAAC,EAAE,gBAAM,CAAC,CAAC;AACxC,IAAA,yBAAmB,EAAC,MAAM,EAAE,OAAC,EAAE,gBAAM,CAAC,CAAC;AACvC,IAAA,0BAAkB,EAAC,MAAM,EAAE,OAAC,EAAE,gBAAM,CAAC,CAAC;AACtC,IAAA,+BAAoB,EAAC,MAAM,EAAE,OAAC,EAAE,gBAAM,CAAC,CAAC;AAExC,sBAAsB;AACtB,KAAK,UAAU,IAAI;IACjB,MAAM,SAAS,GAAG,IAAI,+BAAoB,EAAE,CAAC;IAC7C,MAAM,MAAM,CAAC,OAAO,CAAC,SAAS,CAAC,CAAC;AAClC,CAAC;AAED,IAAI,EAAE,CAAC,KAAK,CAAC,CAAC,GAAU,EAAE,EAAE;IAC1B,OAAO,CAAC,KAAK,CAAC,oBAAoB,GAAG,CAAC,OAAO,EAAE,CAAC,CAAC;IACjD,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;AAClB,CAAC,CAAC,CAAC"}

package/dist/lib/agent-registry.d.ts

@@ -0,0 +1,17 @@
+export interface AgentInfo {
+    id: string;
+    name: string;
+    provider: string;
+    model: string;
+    soul: string;
+    rank: string;
+    enabled: boolean;
+}
+/** Detect agents directory dynamically (project-local first, cross-platform) */
+export declare function detectAgentsDir(): string | null;
+/** List all registered agents from the agents directory */
+export declare function listAgents(agentsDir: string | null): AgentInfo[];
+/** Find agent by name (case-insensitive) */
+export declare function findAgent(agentsDir: string | null, name: string): AgentInfo | null;
+/** Read global config */
+export declare function readGlobalConfig(agentsDir: string | null): Record<string, unknown> | null;

package/dist/lib/agent-registry.js

@@ -0,0 +1,67 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.detectAgentsDir = detectAgentsDir;
+exports.listAgents = listAgents;
+exports.findAgent = findAgent;
+exports.readGlobalConfig = readGlobalConfig;
+// Soul v9.0 — Dynamic agent registry. Detects agents from N2 Browser config.
+const fs_1 = __importDefault(require("fs"));
+const path_1 = __importDefault(require("path"));
+const utils_1 = require("./utils");
+const paths_1 = require("./paths");
+/** Detect agents directory dynamically (project-local first, cross-platform) */
+function detectAgentsDir() {
+    const candidates = [
+        process.env.N2_AGENTS_DIR,
+        (0, paths_1.getAgentsDir)(),
+        path_1.default.join(process.cwd(), '_data', 'agents'),
+    ];
+    for (const dir of candidates) {
+        if (dir && fs_1.default.existsSync(dir))
+            return dir;
+    }
+    return null;
+}
+/** List all registered agents from the agents directory */
+function listAgents(agentsDir) {
+    if (!agentsDir || !fs_1.default.existsSync(agentsDir))
+        return [];
+    try {
+        return fs_1.default.readdirSync(agentsDir)
+            .filter(f => f.endsWith('.json') && f !== 'global.json')
+            .map((f) => {
+            const data = (0, utils_1.readJson)(path_1.default.join(agentsDir, f));
+            if (!data)
+                return null;
+            return {
+                id: data.id || path_1.default.basename(f, '.json'),
+                name: data.name || 'unknown',
+                provider: data.provider || 'unknown',
+                model: data.model || 'unknown',
+                soul: data.soul || '',
+                rank: data.rank || '?',
+                enabled: data.enabled !== false,
+            };
+        })
+            .filter((a) => a !== null && a.enabled);
+    }
+    catch (e) {
+        (0, utils_1.logError)('listAgents', e);
+        return [];
+    }
+}
+/** Find agent by name (case-insensitive) */
+function findAgent(agentsDir, name) {
+    const agents = listAgents(agentsDir);
+    return agents.find(a => a.name.toLowerCase() === name.toLowerCase()) || null;
+}
+/** Read global config */
+function readGlobalConfig(agentsDir) {
+    if (!agentsDir)
+        return null;
+    return (0, utils_1.readJson)(path_1.default.join(agentsDir, 'global.json'));
+}
+//# sourceMappingURL=agent-registry.js.map

package/dist/lib/agent-registry.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"agent-registry.js","sourceRoot":"","sources":["../../src/lib/agent-registry.ts"],"names":[],"mappings":";;;;;AA2BA,0CAWC;AAGD,gCAuBC;AAGD,8BAGC;AAGD,4CAGC;AA5ED,6EAA6E;AAC7E,4CAAoB;AACpB,gDAAwB;AACxB,mCAA6C;AAC7C,mCAAuC;AAsBvC,gFAAgF;AAChF,SAAgB,eAAe;IAC7B,MAAM,UAAU,GAA2B;QACzC,OAAO,CAAC,GAAG,CAAC,aAAa;QACzB,IAAA,oBAAY,GAAE;QACd,cAAI,CAAC,IAAI,CAAC,OAAO,CAAC,GAAG,EAAE,EAAE,OAAO,EAAE,QAAQ,CAAC;KAC5C,CAAC;IAEF,KAAK,MAAM,GAAG,IAAI,UAAU,EAAE,CAAC;QAC7B,IAAI,GAAG,IAAI,YAAE,CAAC,UAAU,CAAC,GAAG,CAAC;YAAE,OAAO,GAAG,CAAC;IAC5C,CAAC;IACD,OAAO,IAAI,CAAC;AACd,CAAC;AAED,2DAA2D;AAC3D,SAAgB,UAAU,CAAC,SAAwB;IACjD,IAAI,CAAC,SAAS,IAAI,CAAC,YAAE,CAAC,UAAU,CAAC,SAAS,CAAC;QAAE,OAAO,EAAE,CAAC;IACvD,IAAI,CAAC;QACH,OAAO,YAAE,CAAC,WAAW,CAAC,SAAS,CAAC;aAC7B,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,QAAQ,CAAC,OAAO,CAAC,IAAI,CAAC,KAAK,aAAa,CAAC;aACvD,GAAG,CAAC,CAAC,CAAC,EAAoB,EAAE;YAC3B,MAAM,IAAI,GAAG,IAAA,gBAAQ,EAAgB,cAAI,CAAC,IAAI,CAAC,SAAS,EAAE,CAAC,CAAC,CAAC,CAAC;YAC9D,IAAI,CAAC,IAAI;gBAAE,OAAO,IAAI,CAAC;YACvB,OAAO;gBACL,EAAE,EAAE,IAAI,CAAC,EAAE,IAAI,cAAI,CAAC,QAAQ,CAAC,CAAC,EAAE,OAAO,CAAC;gBACxC,IAAI,EAAE,IAAI,CAAC,IAAI,IAAI,SAAS;gBAC5B,QAAQ,EAAE,IAAI,CAAC,QAAQ,IAAI,SAAS;gBACpC,KAAK,EAAE,IAAI,CAAC,KAAK,IAAI,SAAS;gBAC9B,IAAI,EAAE,IAAI,CAAC,IAAI,IAAI,EAAE;gBACrB,IAAI,EAAE,IAAI,CAAC,IAAI,IAAI,GAAG;gBACtB,OAAO,EAAE,IAAI,CAAC,OAAO,KAAK,KAAK;aAChC,CAAC;QACJ,CAAC,CAAC;aACD,MAAM,CAAC,CAAC,CAAC,EAAkB,EAAE,CAAC,CAAC,KAAK,IAAI,IAAI,CAAC,CAAC,OAAO,CAAC,CAAC;IAC5D,CAAC;IAAC,OAAO,CAAC,EAAE,CAAC;QACX,IAAA,gBAAQ,EAAC,YAAY,EAAE,CAAC,CAAC,CAAC;QAC1B,OAAO,EAAE,CAAC;IACZ,CAAC;AACH,CAAC;AAED,4CAA4C;AAC5C,SAAgB,SAAS,CAAC,SAAwB,EAAE,IAAY;IAC9D,MAAM,MAAM,GAAG,UAAU,CAAC,SAAS,CAAC,CAAC;IACrC,OAAO,MAAM,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,WAAW,EAAE,KAAK,IAAI,CAAC,WAAW,EAAE,CAAC,IAAI,IAAI,CAAC;AAC/E,CAAC;AAED,yBAAyB;AACzB,SAAgB,gBAAgB,CAAC,SAAwB;IACvD,IAAI,CAAC,SAAS;QAAE,OAAO,IAAI,CAAC;IAC5B,OAAO,IAAA,gBAAQ,EAA0B,cAAI,CAAC,IAAI,CAAC,SAAS,EAAE,aAAa,CAAC,CAAC,CAAC;AAChF,CAAC"}

package/dist/lib/config.d.ts

@@ -0,0 +1,3 @@
+import type { SoulConfig } from '../types';
+declare const config: SoulConfig;
+export default config;

package/dist/lib/config.default.d.ts

@@ -0,0 +1,3 @@
+import type { SoulConfig } from '../types';
+declare const defaults: SoulConfig;
+export default defaults;

package/dist/lib/config.default.js

@@ -0,0 +1,66 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+// Soul v9.0 — Default config. Zero hardcoded paths, all dynamic.
+const path_1 = __importDefault(require("path"));
+const defaults = {
+    SOUL_ROOT: path_1.default.resolve(__dirname, '..', '..'),
+    DATA_DIR: path_1.default.resolve(__dirname, '..', '..', 'data'),
+    TIMEZONE: 'Asia/Seoul',
+    AGENTS_DIR: null,
+    LANG: process.env.N2_LANG || 'en',
+    SEARCH: {
+        maxDepth: 6,
+        minKeywordLength: 2,
+        previewLength: 200,
+        recencyBonus: 10,
+        defaultMaxResults: 10,
+        semanticEnabled: false,
+        semanticWeight: 0.3,
+    },
+    FILE_TREE: {
+        hidePaths: ['test', '_data', '_history', 'soul/data/kv-cache'],
+        compactPaths: ['soul/data/projects', 'soul/data/memory'],
+        childLimit: 20,
+    },
+    WORK: {
+        sessionTtlHours: 24,
+        maxDecisions: 20,
+    },
+    KV_CACHE: {
+        enabled: true,
+        autoSaveOnWorkEnd: true,
+        autoLoadOnBoot: true,
+        backend: 'json',
+        maxSnapshotsPerProject: 50,
+        maxSnapshotAgeDays: 30,
+        compressionTarget: 1000,
+        snapshotDir: null,
+        sqliteDir: null,
+        tokenBudget: {
+            bootContext: 2000,
+            searchResult: 500,
+            progressiveLoad: true,
+        },
+        tier: {
+            hotDays: 7,
+            warmDays: 30,
+        },
+        embedding: {
+            enabled: false,
+            model: 'nomic-embed-text',
+            endpoint: null,
+        },
+        backup: {
+            enabled: false,
+            dir: null,
+            schedule: 'daily',
+            keepCount: 7,
+            incremental: true,
+        },
+    },
+};
+exports.default = defaults;
+//# sourceMappingURL=config.default.js.map

package/dist/lib/config.default.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"config.default.js","sourceRoot":"","sources":["../../src/lib/config.default.ts"],"names":[],"mappings":";;;;;AAAA,iEAAiE;AACjE,gDAAwB;AAGxB,MAAM,QAAQ,GAAe;IAC3B,SAAS,EAAE,cAAI,CAAC,OAAO,CAAC,SAAS,EAAE,IAAI,EAAE,IAAI,CAAC;IAC9C,QAAQ,EAAE,cAAI,CAAC,OAAO,CAAC,SAAS,EAAE,IAAI,EAAE,IAAI,EAAE,MAAM,CAAC;IACrD,QAAQ,EAAE,YAAY;IACtB,UAAU,EAAE,IAAI;IAChB,IAAI,EAAE,OAAO,CAAC,GAAG,CAAC,OAAO,IAAI,IAAI;IAEjC,MAAM,EAAE;QACN,QAAQ,EAAE,CAAC;QACX,gBAAgB,EAAE,CAAC;QACnB,aAAa,EAAE,GAAG;QAClB,YAAY,EAAE,EAAE;QAChB,iBAAiB,EAAE,EAAE;QACrB,eAAe,EAAE,KAAK;QACtB,cAAc,EAAE,GAAG;KACpB;IAED,SAAS,EAAE;QACT,SAAS,EAAE,CAAC,MAAM,EAAE,OAAO,EAAE,UAAU,EAAE,oBAAoB,CAAC;QAC9D,YAAY,EAAE,CAAC,oBAAoB,EAAE,kBAAkB,CAAC;QACxD,UAAU,EAAE,EAAE;KACf;IAED,IAAI,EAAE;QACJ,eAAe,EAAE,EAAE;QACnB,YAAY,EAAE,EAAE;KACjB;IAED,QAAQ,EAAE;QACR,OAAO,EAAE,IAAI;QACb,iBAAiB,EAAE,IAAI;QACvB,cAAc,EAAE,IAAI;QACpB,OAAO,EAAE,MAAM;QACf,sBAAsB,EAAE,EAAE;QAC1B,kBAAkB,EAAE,EAAE;QACtB,iBAAiB,EAAE,IAAI;QACvB,WAAW,EAAE,IAAI;QACjB,SAAS,EAAE,IAAI;QACf,WAAW,EAAE;YACX,WAAW,EAAE,IAAI;YACjB,YAAY,EAAE,GAAG;YACjB,eAAe,EAAE,IAAI;SACtB;QACD,IAAI,EAAE;YACJ,OAAO,EAAE,CAAC;YACV,QAAQ,EAAE,EAAE;SACb;QACD,SAAS,EAAE;YACT,OAAO,EAAE,KAAK;YACd,KAAK,EAAE,kBAAkB;YACzB,QAAQ,EAAE,IAAI;SACf;QACD,MAAM,EAAE;YACN,OAAO,EAAE,KAAK;YACd,GAAG,EAAE,IAAI;YACT,QAAQ,EAAE,OAAO;YACjB,SAAS,EAAE,CAAC;YACZ,WAAW,EAAE,IAAI;SAClB;KACF;CACF,CAAC;AAEF,kBAAe,QAAQ,CAAC"}

package/dist/lib/config.js

@@ -0,0 +1,36 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+const config_default_1 = __importDefault(require("./config.default"));
+let local = {};
+try {
+    // NOTE: require() intentionally kept — config.local.js is a runtime-optional CJS file
+    // that may or may not exist. Static import cannot handle optional modules gracefully.
+    local = require('./config.local.js');
+}
+catch (e) {
+    const err = e;
+    if (err.code !== 'MODULE_NOT_FOUND')
+        throw e;
+}
+/** Deep merge: local overrides default, nested objects are merged (not replaced) */
+function deepMerge(base, override) {
+    const result = { ...base };
+    for (const key of Object.keys(override)) {
+        const ov = override[key];
+        const bv = base[key];
+        if (ov && typeof ov === 'object' && !Array.isArray(ov) &&
+            bv && typeof bv === 'object' && !Array.isArray(bv)) {
+            result[key] = deepMerge(bv, ov);
+        }
+        else {
+            result[key] = ov;
+        }
+    }
+    return result;
+}
+const config = deepMerge(config_default_1.default, local);
+exports.default = config;
+//# sourceMappingURL=config.js.map

package/dist/lib/config.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"config.js","sourceRoot":"","sources":["../../src/lib/config.ts"],"names":[],"mappings":";;;;;AAEA,sEAAwC;AAMxC,IAAI,KAAK,GAA4B,EAAE,CAAC;AACxC,IAAI,CAAC;IACH,sFAAsF;IACtF,sFAAsF;IACtF,KAAK,GAAG,OAAO,CAAC,mBAAmB,CAAC,CAAC;AACvC,CAAC;AAAC,OAAO,CAAU,EAAE,CAAC;IACpB,MAAM,GAAG,GAAG,CAA0B,CAAC;IACvC,IAAI,GAAG,CAAC,IAAI,KAAK,kBAAkB;QAAE,MAAM,CAAC,CAAC;AAC/C,CAAC;AAED,oFAAoF;AACpF,SAAS,SAAS,CAChB,IAAO,EACP,QAAwB;IAExB,MAAM,MAAM,GAAG,EAAE,GAAG,IAAI,EAA6B,CAAC;IACtD,KAAK,MAAM,GAAG,IAAI,MAAM,CAAC,IAAI,CAAC,QAAQ,CAAC,EAAE,CAAC;QACxC,MAAM,EAAE,GAAG,QAAQ,CAAC,GAA4B,CAAC,CAAC;QAClD,MAAM,EAAE,GAAG,IAAI,CAAC,GAAc,CAAC,CAAC;QAChC,IACE,EAAE,IAAI,OAAO,EAAE,KAAK,QAAQ,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,EAAE,CAAC;YAClD,EAAE,IAAI,OAAO,EAAE,KAAK,QAAQ,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,EAAE,CAAC,EAClD,CAAC;YACD,MAAM,CAAC,GAAG,CAAC,GAAG,SAAS,CACrB,EAA6B,EAC7B,EAA0C,CAC3C,CAAC;QACJ,CAAC;aAAM,CAAC;YACN,MAAM,CAAC,GAAG,CAAC,GAAG,EAAE,CAAC;QACnB,CAAC;IACH,CAAC;IACD,OAAO,MAAW,CAAC;AACrB,CAAC;AAED,MAAM,MAAM,GAAe,SAAS,CAClC,wBAA8C,EAC9C,KAAwD,CAChC,CAAC;AAE3B,kBAAe,MAAM,CAAC"}

package/dist/lib/context.d.ts

@@ -0,0 +1,15 @@
+interface SessionContext {
+    agentName: string | null;
+    kvChain: Record<string, string>;
+}
+/** Get current session context */
+export declare function getContext(): SessionContext;
+/** Set agent name (called during n2_boot) */
+export declare function setAgentName(name: string): void;
+/** Get agent name with fallback */
+export declare function getAgentName(): string;
+/** Set KV chain parent (for session linking) */
+export declare function setKvChainParent(project: string, sessionId: string): void;
+/** Get and consume KV chain parent */
+export declare function popKvChainParent(project: string): string | null;
+export {};

package/dist/lib/context.js

@@ -0,0 +1,35 @@
+"use strict";
+// Soul v9.0 — Session context manager. Replaces global state anti-pattern.
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.getContext = getContext;
+exports.setAgentName = setAgentName;
+exports.getAgentName = getAgentName;
+exports.setKvChainParent = setKvChainParent;
+exports.popKvChainParent = popKvChainParent;
+const _ctx = {
+    agentName: null,
+    kvChain: {},
+};
+/** Get current session context */
+function getContext() {
+    return _ctx;
+}
+/** Set agent name (called during n2_boot) */
+function setAgentName(name) {
+    _ctx.agentName = name;
+}
+/** Get agent name with fallback */
+function getAgentName() {
+    return _ctx.agentName || process.env.N2_AGENT_NAME || 'default';
+}
+/** Set KV chain parent (for session linking) */
+function setKvChainParent(project, sessionId) {
+    _ctx.kvChain[project] = sessionId;
+}
+/** Get and consume KV chain parent */
+function popKvChainParent(project) {
+    const parent = _ctx.kvChain[project] || null;
+    delete _ctx.kvChain[project];
+    return parent;
+}
+//# sourceMappingURL=context.js.map

package/dist/lib/context.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"context.js","sourceRoot":"","sources":["../../src/lib/context.ts"],"names":[],"mappings":";AAAA,2EAA2E;;AAa3E,gCAEC;AAGD,oCAEC;AAGD,oCAEC;AAGD,4CAEC;AAGD,4CAIC;AA9BD,MAAM,IAAI,GAAmB;IAC3B,SAAS,EAAE,IAAI;IACf,OAAO,EAAE,EAAE;CACZ,CAAC;AAEF,kCAAkC;AAClC,SAAgB,UAAU;IACxB,OAAO,IAAI,CAAC;AACd,CAAC;AAED,6CAA6C;AAC7C,SAAgB,YAAY,CAAC,IAAY;IACvC,IAAI,CAAC,SAAS,GAAG,IAAI,CAAC;AACxB,CAAC;AAED,mCAAmC;AACnC,SAAgB,YAAY;IAC1B,OAAO,IAAI,CAAC,SAAS,IAAI,OAAO,CAAC,GAAG,CAAC,aAAa,IAAI,SAAS,CAAC;AAClE,CAAC;AAED,gDAAgD;AAChD,SAAgB,gBAAgB,CAAC,OAAe,EAAE,SAAiB;IACjE,IAAI,CAAC,OAAO,CAAC,OAAO,CAAC,GAAG,SAAS,CAAC;AACpC,CAAC;AAED,sCAAsC;AACtC,SAAgB,gBAAgB,CAAC,OAAe;IAC9C,MAAM,MAAM,GAAG,IAAI,CAAC,OAAO,CAAC,OAAO,CAAC,IAAI,IAAI,CAAC;IAC7C,OAAO,IAAI,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC;IAC7B,OAAO,MAAM,CAAC;AAChB,CAAC"}

package/dist/lib/core-memory.d.ts

@@ -0,0 +1,34 @@
+interface CoreMemoryFile {
+    agent: string;
+    memory: Record<string, string>;
+    updatedAt: string;
+}
+/**
+ * CoreMemory — Agent-specific always-loaded memory.
+ * Automatically included in context at boot.
+ * Data path: data/memory/core-memory/{agent}.json
+ */
+export declare class CoreMemory {
+    private readonly dir;
+    private _cache;
+    constructor(dataDir: string);
+    /** Agent core memory file path */
+    private _filePath;
+    /** Load agent core memory */
+    read(agentName: string): CoreMemoryFile;
+    /** Write key-value to core memory */
+    write(agentName: string, key: string, value: string): {
+        action: string;
+    };
+    /** Remove key from core memory */
+    remove(agentName: string, key: string): boolean;
+    /** List all keys for an agent */
+    keys(agentName: string): string[];
+    /** Generate prompt text for boot injection */
+    toPrompt(agentName: string, maxTokens?: number): string;
+    /** Summary of all agents' core memories */
+    toContextAll(): string;
+    /** Invalidate cache */
+    invalidateCache(): void;
+}
+export {};