memnant 0.1.0

package/dist/types.d.ts

@@ -0,0 +1,99 @@
+/**
+ * memnant — Shared type definitions.
+ *
+ * These types mirror the data model defined in docs/SPEC.md.
+ * If the spec changes, these types change. If these types change
+ * without the spec changing, something is wrong.
+ */
+export declare const RECORD_TYPES: readonly ["session_log", "decision", "framework_fix", "spec_snapshot", "codebase_snapshot", "orchestrator_task"];
+export type RecordType = (typeof RECORD_TYPES)[number];
+export interface Project {
+    id: string;
+    name: string;
+    root_path: string;
+    created_at: string;
+}
+export interface Record {
+    id: string;
+    project_id: string;
+    type: RecordType;
+    content: object;
+    content_text: string;
+    embedding?: Float32Array;
+    tags: string[];
+    related_records: string[];
+    created_at: string;
+    source_session: string | null;
+    staleness_marker: object | null;
+}
+export interface Session {
+    id: string;
+    project_id: string;
+    started_at: string;
+    closed_at: string | null;
+    epic: string | null;
+    stories_completed: string[];
+    log_record_id: string | null;
+    log_skipped: string | null;
+}
+export interface ProjectConfig {
+    project: {
+        name: string;
+        id: string;
+    };
+    memory: {
+        db_path: string;
+        export_path: string;
+        snapshot_interval: 'monthly' | 'milestone';
+        max_spec_snapshots: number;
+        max_codebase_snapshots: number;
+    };
+    orchestrator: {
+        tiers: {
+            triage: TierConfig;
+            analysis: TierConfig;
+            build: TierConfig;
+        };
+        interfaces: {
+            telegram: {
+                enabled: boolean;
+            };
+            cli: {
+                enabled: boolean;
+            };
+            mcp: {
+                enabled: boolean;
+                port: number;
+            };
+        };
+    };
+    governor: {
+        docs_path: string;
+        lint_on_pr: boolean;
+        strict_mode: boolean;
+    };
+    security: {
+        staging_only: boolean;
+        allow_deploy: boolean;
+        allowed_mcp_tools: string[];
+    };
+}
+export interface TierConfig {
+    provider: string;
+    model: string;
+    max_context_tokens?: number;
+}
+export interface CompiledContext {
+    token_estimate: number;
+    warnings: string[];
+    sections: {
+        last_session: string | null;
+        open_todos: string[];
+        epic_context: string | null;
+        framework_fixes: string[];
+        spec_constraints: string[];
+        persona_tests: string[];
+        stale_decisions: string[];
+    };
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"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"}

package/dist/types.js

@@ -0,0 +1,16 @@
+/**
+ * memnant — Shared type definitions.
+ *
+ * These types mirror the data model defined in docs/SPEC.md.
+ * If the spec changes, these types change. If these types change
+ * without the spec changing, something is wrong.
+ */
+export const RECORD_TYPES = [
+    'session_log',
+    'decision',
+    'framework_fix',
+    'spec_snapshot',
+    'codebase_snapshot',
+    'orchestrator_task',
+];
+//# sourceMappingURL=types.js.map

package/dist/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,MAAM,CAAC,MAAM,YAAY,GAAG;IAC1B,aAAa;IACb,UAAU;IACV,eAAe;IACf,eAAe;IACf,mBAAmB;IACnB,mBAAmB;CACX,CAAC"}

package/dist/vector/embeddings.d.ts

@@ -0,0 +1,11 @@
+/**
+ * memnant — Embedding pipeline.
+ *
+ * Story 1.2: Generates embeddings for record content using a local model.
+ * Uses @xenova/transformers with all-MiniLM-L6-v2 (384-dimensional, normalized).
+ * The pipeline is lazily initialised on first call and cached in a module-level variable.
+ */
+export declare function generateEmbedding(text: string): Promise<Float32Array>;
+export declare function serializeEmbedding(embedding: Float32Array): Buffer;
+export declare function deserializeEmbedding(buffer: Uint8Array): Float32Array;
+//# sourceMappingURL=embeddings.d.ts.map

package/dist/vector/embeddings.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"embeddings.d.ts","sourceRoot":"","sources":["../../src/vector/embeddings.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAeH,wBAAsB,iBAAiB,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,YAAY,CAAC,CAI3E;AAED,wBAAgB,kBAAkB,CAAC,SAAS,EAAE,YAAY,GAAG,MAAM,CAElE;AAED,wBAAgB,oBAAoB,CAAC,MAAM,EAAE,UAAU,GAAG,YAAY,CAMrE"}

package/dist/vector/embeddings.js

@@ -0,0 +1,30 @@
+/**
+ * memnant — Embedding pipeline.
+ *
+ * Story 1.2: Generates embeddings for record content using a local model.
+ * Uses @xenova/transformers with all-MiniLM-L6-v2 (384-dimensional, normalized).
+ * The pipeline is lazily initialised on first call and cached in a module-level variable.
+ */
+import { pipeline } from '@xenova/transformers';
+// eslint-disable-next-line @typescript-eslint/no-explicit-any
+let pipelineInstance = null;
+async function getPipeline() {
+    if (!pipelineInstance) {
+        process.stderr.write('Loading embedding model...\n');
+        pipelineInstance = await pipeline('feature-extraction', 'Xenova/all-MiniLM-L6-v2');
+    }
+    return pipelineInstance;
+}
+export async function generateEmbedding(text) {
+    const extractor = await getPipeline();
+    const output = await extractor(text, { pooling: 'mean', normalize: true });
+    return new Float32Array(output.data);
+}
+export function serializeEmbedding(embedding) {
+    return Buffer.from(embedding.buffer, embedding.byteOffset, embedding.byteLength);
+}
+export function deserializeEmbedding(buffer) {
+    const arrayBuffer = buffer.buffer.slice(buffer.byteOffset, buffer.byteOffset + buffer.byteLength);
+    return new Float32Array(arrayBuffer);
+}
+//# sourceMappingURL=embeddings.js.map

package/dist/vector/embeddings.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"embeddings.js","sourceRoot":"","sources":["../../src/vector/embeddings.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,EAAE,QAAQ,EAAE,MAAM,sBAAsB,CAAC;AAEhD,8DAA8D;AAC9D,IAAI,gBAAgB,GAAQ,IAAI,CAAC;AAEjC,KAAK,UAAU,WAAW;IACxB,IAAI,CAAC,gBAAgB,EAAE,CAAC;QACtB,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,8BAA8B,CAAC,CAAC;QACrD,gBAAgB,GAAG,MAAM,QAAQ,CAAC,oBAAoB,EAAE,yBAAyB,CAAC,CAAC;IACrF,CAAC;IACD,OAAO,gBAAgB,CAAC;AAC1B,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,iBAAiB,CAAC,IAAY;IAClD,MAAM,SAAS,GAAG,MAAM,WAAW,EAAE,CAAC;IACtC,MAAM,MAAM,GAAG,MAAM,SAAS,CAAC,IAAI,EAAE,EAAE,OAAO,EAAE,MAAM,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;IAC3E,OAAO,IAAI,YAAY,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC;AACvC,CAAC;AAED,MAAM,UAAU,kBAAkB,CAAC,SAAuB;IACxD,OAAO,MAAM,CAAC,IAAI,CAAC,SAAS,CAAC,MAAM,EAAE,SAAS,CAAC,UAAU,EAAE,SAAS,CAAC,UAAU,CAAC,CAAC;AACnF,CAAC;AAED,MAAM,UAAU,oBAAoB,CAAC,MAAkB;IACrD,MAAM,WAAW,GAAG,MAAM,CAAC,MAAM,CAAC,KAAK,CACrC,MAAM,CAAC,UAAU,EACjB,MAAM,CAAC,UAAU,GAAG,MAAM,CAAC,UAAU,CACtC,CAAC;IACF,OAAO,IAAI,YAAY,CAAC,WAAW,CAAC,CAAC;AACvC,CAAC"}

package/dist/vector/search.d.ts

@@ -0,0 +1,26 @@
+/**
+ * memnant — Vector search over the ledger.
+ *
+ * Story 1.3: Brute-force cosine similarity search using dot product on
+ * normalized embeddings. SQL pre-filters by type and date before computing
+ * similarity in-memory. Correct for the 500-record target (~750 KB of embeddings).
+ */
+import type { Database } from '../ledger/database.js';
+import type { RecordType } from '../types.js';
+export interface RecallFilters {
+    type?: RecordType;
+    since?: string;
+    limit: number;
+}
+export interface RecallResult {
+    id: string;
+    type: string;
+    content_text: string;
+    created_at: string;
+    tags: string[];
+    related_records: string[];
+    similarity: number;
+}
+export declare function dotProduct(a: Float32Array, b: Float32Array): number;
+export declare function searchRecords(db: Database, queryEmbedding: Float32Array, filters: RecallFilters): RecallResult[];
+//# sourceMappingURL=search.d.ts.map

package/dist/vector/search.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"search.d.ts","sourceRoot":"","sources":["../../src/vector/search.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,uBAAuB,CAAC;AACtD,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AAK9C,MAAM,WAAW,aAAa;IAC5B,IAAI,CAAC,EAAE,UAAU,CAAC;IAClB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,KAAK,EAAE,MAAM,CAAC;CACf;AAED,MAAM,WAAW,YAAY;IAC3B,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;IACb,YAAY,EAAE,MAAM,CAAC;IACrB,UAAU,EAAE,MAAM,CAAC;IACnB,IAAI,EAAE,MAAM,EAAE,CAAC;IACf,eAAe,EAAE,MAAM,EAAE,CAAC;IAC1B,UAAU,EAAE,MAAM,CAAC;CACpB;AAYD,wBAAgB,UAAU,CAAC,CAAC,EAAE,YAAY,EAAE,CAAC,EAAE,YAAY,GAAG,MAAM,CAMnE;AAED,wBAAgB,aAAa,CAC3B,EAAE,EAAE,QAAQ,EACZ,cAAc,EAAE,YAAY,EAC5B,OAAO,EAAE,aAAa,GACrB,YAAY,EAAE,CAwChB"}

package/dist/vector/search.js

@@ -0,0 +1,51 @@
+/**
+ * memnant — Vector search over the ledger.
+ *
+ * Story 1.3: Brute-force cosine similarity search using dot product on
+ * normalized embeddings. SQL pre-filters by type and date before computing
+ * similarity in-memory. Correct for the 500-record target (~750 KB of embeddings).
+ */
+import { deserializeEmbedding } from './embeddings.js';
+const MIN_SIMILARITY_THRESHOLD = 0.3;
+export function dotProduct(a, b) {
+    let sum = 0;
+    for (let i = 0; i < a.length; i++) {
+        sum += a[i] * b[i];
+    }
+    return sum;
+}
+export function searchRecords(db, queryEmbedding, filters) {
+    const conditions = ['embedding IS NOT NULL'];
+    const params = [];
+    if (filters.type) {
+        conditions.push('type = ?');
+        params.push(filters.type);
+    }
+    if (filters.since) {
+        conditions.push('created_at >= ?');
+        params.push(filters.since);
+    }
+    const sql = `SELECT id, type, content_text, created_at, tags, related_records, embedding
+    FROM record
+    WHERE ${conditions.join(' AND ')}`;
+    const rows = db.all(sql, params);
+    const scored = [];
+    for (const row of rows) {
+        const rowEmbedding = deserializeEmbedding(row.embedding);
+        const similarity = dotProduct(queryEmbedding, rowEmbedding);
+        if (similarity >= MIN_SIMILARITY_THRESHOLD) {
+            scored.push({
+                id: row.id,
+                type: row.type,
+                content_text: row.content_text,
+                created_at: row.created_at,
+                tags: JSON.parse(row.tags),
+                related_records: JSON.parse(row.related_records),
+                similarity,
+            });
+        }
+    }
+    scored.sort((a, b) => b.similarity - a.similarity);
+    return scored.slice(0, filters.limit);
+}
+//# sourceMappingURL=search.js.map

package/dist/vector/search.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"search.js","sourceRoot":"","sources":["../../src/vector/search.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAIH,OAAO,EAAE,oBAAoB,EAAE,MAAM,iBAAiB,CAAC;AAEvD,MAAM,wBAAwB,GAAG,GAAG,CAAC;AA4BrC,MAAM,UAAU,UAAU,CAAC,CAAe,EAAE,CAAe;IACzD,IAAI,GAAG,GAAG,CAAC,CAAC;IACZ,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,CAAC,CAAC,MAAM,EAAE,CAAC,EAAE,EAAE,CAAC;QAClC,GAAG,IAAI,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC;IACrB,CAAC;IACD,OAAO,GAAG,CAAC;AACb,CAAC;AAED,MAAM,UAAU,aAAa,CAC3B,EAAY,EACZ,cAA4B,EAC5B,OAAsB;IAEtB,MAAM,UAAU,GAAG,CAAC,uBAAuB,CAAC,CAAC;IAC7C,MAAM,MAAM,GAAwB,EAAE,CAAC;IAEvC,IAAI,OAAO,CAAC,IAAI,EAAE,CAAC;QACjB,UAAU,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC;QAC5B,MAAM,CAAC,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC;IAC5B,CAAC;IAED,IAAI,OAAO,CAAC,KAAK,EAAE,CAAC;QAClB,UAAU,CAAC,IAAI,CAAC,iBAAiB,CAAC,CAAC;QACnC,MAAM,CAAC,IAAI,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC;IAC7B,CAAC;IAED,MAAM,GAAG,GAAG;;YAEF,UAAU,CAAC,IAAI,CAAC,OAAO,CAAC,EAAE,CAAC;IAErC,MAAM,IAAI,GAAG,EAAE,CAAC,GAAG,CAAC,GAAG,EAAE,MAAM,CAA8B,CAAC;IAE9D,MAAM,MAAM,GAAmB,EAAE,CAAC;IAClC,KAAK,MAAM,GAAG,IAAI,IAAI,EAAE,CAAC;QACvB,MAAM,YAAY,GAAG,oBAAoB,CAAC,GAAG,CAAC,SAAS,CAAC,CAAC;QACzD,MAAM,UAAU,GAAG,UAAU,CAAC,cAAc,EAAE,YAAY,CAAC,CAAC;QAE5D,IAAI,UAAU,IAAI,wBAAwB,EAAE,CAAC;YAC3C,MAAM,CAAC,IAAI,CAAC;gBACV,EAAE,EAAE,GAAG,CAAC,EAAE;gBACV,IAAI,EAAE,GAAG,CAAC,IAAI;gBACd,YAAY,EAAE,GAAG,CAAC,YAAY;gBAC9B,UAAU,EAAE,GAAG,CAAC,UAAU;gBAC1B,IAAI,EAAE,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,IAAI,CAAC;gBAC1B,eAAe,EAAE,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,eAAe,CAAC;gBAChD,UAAU;aACX,CAAC,CAAC;QACL,CAAC;IACH,CAAC;IAED,MAAM,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,UAAU,GAAG,CAAC,CAAC,UAAU,CAAC,CAAC;IACnD,OAAO,MAAM,CAAC,KAAK,CAAC,CAAC,EAAE,OAAO,CAAC,KAAK,CAAC,CAAC;AACxC,CAAC"}

package/package.json

@@ -0,0 +1,57 @@
+{
+  "name": "memnant",
+  "version": "0.1.0",
+  "description": "The context layer for agent-operated products",
+  "type": "module",
+  "bin": {
+    "memnant": "./dist/cli/index.js"
+  },
+  "main": "./dist/index.js",
+  "files": [
+    "dist/"
+  ],
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/peureka/memnant.git"
+  },
+  "scripts": {
+    "build": "tsc",
+    "dev": "tsc --watch",
+    "test": "vitest run",
+    "test:watch": "vitest",
+    "lint": "tsc --noEmit",
+    "start:mcp": "node dist/mcp/server.js",
+    "prepublishOnly": "npm run build && npm test"
+  },
+  "dependencies": {
+    "@anthropic-ai/sdk": "^0.78.0",
+    "@modelcontextprotocol/sdk": "^1.12.0",
+    "@xenova/transformers": "^2.17.0",
+    "node-sqlite3-wasm": "^0.8.30",
+    "commander": "^13.1.0",
+    "js-yaml": "^4.1.0",
+    "openai": "^6.25.0",
+    "smol-toml": "^1.6.0",
+    "telegraf": "^4.16.3",
+    "uuid": "^11.1.0"
+  },
+  "devDependencies": {
+    "@types/js-yaml": "^4.0.9",
+    "@types/node": "^22.12.0",
+    "@types/uuid": "^10.0.0",
+    "typescript": "^5.7.0",
+    "vitest": "^3.0.0"
+  },
+  "engines": {
+    "node": ">=20.0.0"
+  },
+  "keywords": [
+    "ai",
+    "agents",
+    "context",
+    "memory",
+    "mcp",
+    "cli"
+  ],
+  "license": "MIT"
+}