@pcircle/memesh 2.11.0 → 3.0.0

package/dist/core/types.d.ts

@@ -0,0 +1,124 @@
+export interface Entity {
+    id: number;
+    name: string;
+    type: string;
+    created_at: string;
+    metadata?: any;
+    observations: string[];
+    tags: string[];
+    relations?: Relation[];
+    archived?: boolean;
+    access_count?: number;
+    last_accessed_at?: string;
+    confidence?: number;
+    valid_from?: string;
+    valid_until?: string;
+    namespace?: string;
+}
+export interface Relation {
+    from: string;
+    to: string;
+    type: string;
+    metadata?: any;
+}
+export interface CreateEntityInput {
+    name: string;
+    type: string;
+    observations?: string[];
+    tags?: string[];
+    metadata?: any;
+    namespace?: string;
+}
+export interface SearchOptions {
+    tag?: string;
+    limit?: number;
+    includeArchived?: boolean;
+    namespace?: string;
+}
+export interface RememberInput {
+    name: string;
+    type: string;
+    observations?: string[];
+    tags?: string[];
+    relations?: Array<{
+        to: string;
+        type: string;
+    }>;
+    namespace?: string;
+}
+export interface RecallInput {
+    query?: string;
+    tag?: string;
+    limit?: number;
+    include_archived?: boolean;
+    namespace?: string;
+    cross_project?: boolean;
+}
+export interface ForgetInput {
+    name: string;
+    observation?: string;
+}
+export interface RememberResult {
+    stored: boolean;
+    entityId: number;
+    name: string;
+    type: string;
+    observations: number;
+    tags: number;
+    relations: number;
+    superseded?: string[];
+    relationErrors?: string[];
+}
+export interface ForgetResult {
+    archived?: boolean;
+    name?: string;
+    message?: string;
+    observation_removed?: boolean;
+    observation?: string;
+    remaining_observations?: number;
+}
+export interface ConsolidateInput {
+    name?: string;
+    tag?: string;
+    min_observations?: number;
+}
+export interface ConsolidateResult {
+    consolidated: number;
+    entities_processed: string[];
+    observations_before: number;
+    observations_after: number;
+    error?: string;
+}
+export interface ExportInput {
+    tag?: string;
+    namespace?: string;
+    limit?: number;
+}
+export interface ExportResult {
+    version: string;
+    exported_at: string;
+    entity_count: number;
+    entities: Array<{
+        name: string;
+        type: string;
+        namespace: string;
+        observations: string[];
+        tags: string[];
+        relations: Array<{
+            to: string;
+            type: string;
+        }>;
+    }>;
+}
+export interface ImportInput {
+    data: ExportResult;
+    namespace?: string;
+    merge_strategy: 'skip' | 'overwrite' | 'append';
+}
+export interface ImportResult {
+    imported: number;
+    skipped: number;
+    appended: number;
+    errors: string[];
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/core/types.d.ts.map

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

package/dist/core/types.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=types.js.map

package/dist/core/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/core/types.ts"],"names":[],"mappings":""}

package/dist/core/version-check.d.ts

@@ -0,0 +1,10 @@
+interface UpdateCheck {
+    currentVersion: string;
+    latestVersion: string | null;
+    checkedAt: string;
+    updateAvailable: boolean;
+}
+export declare function checkForUpdate(currentVersion: string): Promise<UpdateCheck>;
+export declare function getLastUpdateCheck(): UpdateCheck | null;
+export {};
+//# sourceMappingURL=version-check.d.ts.map

package/dist/core/version-check.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"version-check.d.ts","sourceRoot":"","sources":["../../src/core/version-check.ts"],"names":[],"mappings":"AAOA,UAAU,WAAW;IACnB,cAAc,EAAE,MAAM,CAAC;IACvB,aAAa,EAAE,MAAM,GAAG,IAAI,CAAC;IAC7B,SAAS,EAAE,MAAM,CAAC;IAClB,eAAe,EAAE,OAAO,CAAC;CAC1B;AAMD,wBAAsB,cAAc,CAAC,cAAc,EAAE,MAAM,GAAG,OAAO,CAAC,WAAW,CAAC,CA4BjF;AAKD,wBAAgB,kBAAkB,IAAI,WAAW,GAAG,IAAI,CAOvD"}

package/dist/core/version-check.js

@@ -0,0 +1,44 @@
+import fs from 'fs';
+import path from 'path';
+import os from 'os';
+import { execFile } from 'child_process';
+const UPDATE_CHECK_PATH = path.join(os.homedir(), '.memesh', 'update-check.json');
+export async function checkForUpdate(currentVersion) {
+    const result = {
+        currentVersion,
+        latestVersion: null,
+        checkedAt: new Date().toISOString(),
+        updateAvailable: false,
+    };
+    try {
+        const latest = await new Promise((resolve, reject) => {
+            execFile('npm', ['show', '@pcircle/memesh', 'version'], { timeout: 5000 }, (err, stdout) => {
+                if (err)
+                    reject(err);
+                else
+                    resolve(stdout.trim());
+            });
+        });
+        result.latestVersion = latest;
+        result.updateAvailable = latest !== currentVersion;
+    }
+    catch {
+    }
+    try {
+        fs.mkdirSync(path.dirname(UPDATE_CHECK_PATH), { recursive: true });
+        fs.writeFileSync(UPDATE_CHECK_PATH, JSON.stringify(result, null, 2));
+    }
+    catch { }
+    return result;
+}
+export function getLastUpdateCheck() {
+    try {
+        if (!fs.existsSync(UPDATE_CHECK_PATH))
+            return null;
+        return JSON.parse(fs.readFileSync(UPDATE_CHECK_PATH, 'utf8'));
+    }
+    catch {
+        return null;
+    }
+}
+//# sourceMappingURL=version-check.js.map

package/dist/core/version-check.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"version-check.js","sourceRoot":"","sources":["../../src/core/version-check.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,IAAI,CAAC;AACpB,OAAO,IAAI,MAAM,MAAM,CAAC;AACxB,OAAO,EAAE,MAAM,IAAI,CAAC;AACpB,OAAO,EAAE,QAAQ,EAAE,MAAM,eAAe,CAAC;AAEzC,MAAM,iBAAiB,GAAG,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,OAAO,EAAE,EAAE,SAAS,EAAE,mBAAmB,CAAC,CAAC;AAalF,MAAM,CAAC,KAAK,UAAU,cAAc,CAAC,cAAsB;IACzD,MAAM,MAAM,GAAgB;QAC1B,cAAc;QACd,aAAa,EAAE,IAAI;QACnB,SAAS,EAAE,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE;QACnC,eAAe,EAAE,KAAK;KACvB,CAAC;IAEF,IAAI,CAAC;QACH,MAAM,MAAM,GAAG,MAAM,IAAI,OAAO,CAAS,CAAC,OAAO,EAAE,MAAM,EAAE,EAAE;YAC3D,QAAQ,CAAC,KAAK,EAAE,CAAC,MAAM,EAAE,iBAAiB,EAAE,SAAS,CAAC,EAAE,EAAE,OAAO,EAAE,IAAI,EAAE,EAAE,CAAC,GAAG,EAAE,MAAM,EAAE,EAAE;gBACzF,IAAI,GAAG;oBAAE,MAAM,CAAC,GAAG,CAAC,CAAC;;oBAChB,OAAO,CAAC,MAAM,CAAC,IAAI,EAAE,CAAC,CAAC;YAC9B,CAAC,CAAC,CAAC;QACL,CAAC,CAAC,CAAC;QACH,MAAM,CAAC,aAAa,GAAG,MAAM,CAAC;QAC9B,MAAM,CAAC,eAAe,GAAG,MAAM,KAAK,cAAc,CAAC;IACrD,CAAC;IAAC,MAAM,CAAC;IAET,CAAC;IAGD,IAAI,CAAC;QACH,EAAE,CAAC,SAAS,CAAC,IAAI,CAAC,OAAO,CAAC,iBAAiB,CAAC,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;QACnE,EAAE,CAAC,aAAa,CAAC,iBAAiB,EAAE,IAAI,CAAC,SAAS,CAAC,MAAM,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC,CAAC;IACvE,CAAC;IAAC,MAAM,CAAC,CAAA,CAAC;IAEV,OAAO,MAAM,CAAC;AAChB,CAAC;AAKD,MAAM,UAAU,kBAAkB;IAChC,IAAI,CAAC;QACH,IAAI,CAAC,EAAE,CAAC,UAAU,CAAC,iBAAiB,CAAC;YAAE,OAAO,IAAI,CAAC;QACnD,OAAO,IAAI,CAAC,KAAK,CAAC,EAAE,CAAC,YAAY,CAAC,iBAAiB,EAAE,MAAM,CAAC,CAAC,CAAC;IAChE,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,IAAI,CAAC;IACd,CAAC;AACH,CAAC"}

package/dist/db.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"db.d.ts","sourceRoot":"","sources":["../src/db.ts"],"names":[],"mappings":"AAAA,OAAO,QAAQ,MAAM,gBAAgB,CAAC;AAyDtC,wBAAgB,YAAY,CAAC,MAAM,CAAC,EAAE,MAAM,GAAG,QAAQ,CAAC,QAAQ,CAiB/D;AAED,wBAAgB,aAAa,IAAI,IAAI,CAKpC;AAED,wBAAgB,WAAW,IAAI,QAAQ,CAAC,QAAQ,CAG/C"}
+{"version":3,"file":"db.d.ts","sourceRoot":"","sources":["../src/db.ts"],"names":[],"mappings":"AAAA,OAAO,QAAQ,MAAM,gBAAgB,CAAC;AAkEtC,wBAAgB,YAAY,CAAC,MAAM,CAAC,EAAE,MAAM,GAAG,QAAQ,CAAC,QAAQ,CAsD/D;AAED,wBAAgB,aAAa,IAAI,IAAI,CAKpC;AAED,wBAAgB,WAAW,IAAI,QAAQ,CAAC,QAAQ,CAG/C"}

package/dist/db.js

@@ -1,7 +1,9 @@
 import Database from 'better-sqlite3';
+import * as sqliteVec from 'sqlite-vec';
 import path from 'path';
 import os from 'os';
 import fs from 'fs';
+import { runAutoDecay } from './core/lifecycle.js';
 let db = null;
 const SCHEMA_SQL = `
 CREATE TABLE IF NOT EXISTS entities (
@@ -41,6 +43,13 @@ CREATE TABLE IF NOT EXISTS tags (
 
 CREATE INDEX IF NOT EXISTS idx_tags_entity ON tags(entity_id);
 CREATE INDEX IF NOT EXISTS idx_tags_tag ON tags(tag);
+DELETE FROM tags
+WHERE id NOT IN (
+  SELECT MIN(id)
+  FROM tags
+  GROUP BY entity_id, tag
+);
+CREATE UNIQUE INDEX IF NOT EXISTS idx_tags_entity_tag_unique ON tags(entity_id, tag);
 CREATE INDEX IF NOT EXISTS idx_observations_entity ON observations(entity_id);
 CREATE INDEX IF NOT EXISTS idx_relations_from ON relations(from_entity_id);
 CREATE INDEX IF NOT EXISTS idx_relations_to ON relations(to_entity_id);
@@ -64,6 +73,30 @@ export function openDatabase(dbPath) {
     db.pragma('foreign_keys = ON');
     db.exec(SCHEMA_SQL);
     db.exec(FTS_SQL);
+    const columns = db.prepare("PRAGMA table_info(entities)").all();
+    if (!columns.some((c) => c.name === 'status')) {
+        db.exec("ALTER TABLE entities ADD COLUMN status TEXT NOT NULL DEFAULT 'active'");
+        db.exec("CREATE INDEX IF NOT EXISTS idx_entities_status ON entities(status)");
+    }
+    const scoringCols = db.prepare("PRAGMA table_info(entities)").all();
+    if (!scoringCols.some((c) => c.name === 'access_count')) {
+        db.exec("ALTER TABLE entities ADD COLUMN access_count INTEGER DEFAULT 0");
+        db.exec("ALTER TABLE entities ADD COLUMN last_accessed_at TIMESTAMP");
+        db.exec("ALTER TABLE entities ADD COLUMN confidence REAL DEFAULT 1.0");
+        db.exec("ALTER TABLE entities ADD COLUMN valid_from TIMESTAMP");
+        db.exec("ALTER TABLE entities ADD COLUMN valid_until TIMESTAMP");
+    }
+    if (!scoringCols.some((c) => c.name === 'namespace')) {
+        db.exec("ALTER TABLE entities ADD COLUMN namespace TEXT DEFAULT 'personal'");
+        db.exec("CREATE INDEX IF NOT EXISTS idx_entities_namespace ON entities(namespace)");
+    }
+    runAutoDecay(db);
+    sqliteVec.load(db);
+    db.exec(`
+    CREATE VIRTUAL TABLE IF NOT EXISTS entities_vec USING vec0(
+      embedding float[384]
+    );
+  `);
     return db;
 }
 export function closeDatabase() {

package/dist/db.js.map

@@ -1 +1 @@
-{"version":3,"file":"db.js","sourceRoot":"","sources":["../src/db.ts"],"names":[],"mappings":"AAAA,OAAO,QAAQ,MAAM,gBAAgB,CAAC;AACtC,OAAO,IAAI,MAAM,MAAM,CAAC;AACxB,OAAO,EAAE,MAAM,IAAI,CAAC;AACpB,OAAO,EAAE,MAAM,IAAI,CAAC;AAEpB,IAAI,EAAE,GAA6B,IAAI,CAAC;AAExC,MAAM,UAAU,GAAG;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAyClB,CAAC;AAEF,MAAM,OAAO,GAAG;;;;;CAKf,CAAC;AAEF,MAAM,UAAU,YAAY,CAAC,MAAe;IAC1C,IAAI,EAAE;QAAE,OAAO,EAAE,CAAC;IAElB,MAAM,YAAY,GAAG,MAAM;WACtB,OAAO,CAAC,GAAG,CAAC,cAAc;WAC1B,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,OAAO,EAAE,EAAE,SAAS,EAAE,oBAAoB,CAAC,CAAC;IAE9D,MAAM,GAAG,GAAG,IAAI,CAAC,OAAO,CAAC,YAAY,CAAC,CAAC;IACvC,EAAE,CAAC,SAAS,CAAC,GAAG,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;IAEvC,EAAE,GAAG,IAAI,QAAQ,CAAC,YAAY,CAAC,CAAC;IAChC,EAAE,CAAC,MAAM,CAAC,oBAAoB,CAAC,CAAC;IAChC,EAAE,CAAC,MAAM,CAAC,mBAAmB,CAAC,CAAC;IAC/B,EAAE,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC;IACpB,EAAE,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;IAEjB,OAAO,EAAE,CAAC;AACZ,CAAC;AAED,MAAM,UAAU,aAAa;IAC3B,IAAI,EAAE,EAAE,CAAC;QACP,EAAE,CAAC,KAAK,EAAE,CAAC;QACX,EAAE,GAAG,IAAI,CAAC;IACZ,CAAC;AACH,CAAC;AAED,MAAM,UAAU,WAAW;IACzB,IAAI,CAAC,EAAE;QAAE,MAAM,IAAI,KAAK,CAAC,qBAAqB,CAAC,CAAC;IAChD,OAAO,EAAE,CAAC;AACZ,CAAC"}
+{"version":3,"file":"db.js","sourceRoot":"","sources":["../src/db.ts"],"names":[],"mappings":"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"}

package/dist/knowledge-graph.d.ts

@@ -1,31 +1,6 @@
 import Database from 'better-sqlite3';
-export interface Entity {
-    id: number;
-    name: string;
-    type: string;
-    created_at: string;
-    metadata?: any;
-    observations: string[];
-    tags: string[];
-    relations?: Relation[];
-}
-export interface Relation {
-    from: string;
-    to: string;
-    type: string;
-    metadata?: any;
-}
-export interface CreateEntityInput {
-    name: string;
-    type: string;
-    observations?: string[];
-    tags?: string[];
-    metadata?: any;
-}
-export interface SearchOptions {
-    tag?: string;
-    limit?: number;
-}
+export type { Entity, Relation, CreateEntityInput, SearchOptions } from './core/types.js';
+import type { Entity, Relation, CreateEntityInput, SearchOptions } from './core/types.js';
 export declare class KnowledgeGraph {
     private db;
     constructor(db: Database.Database);
@@ -33,16 +8,27 @@ export declare class KnowledgeGraph {
         observations?: string[];
         tags?: string[];
         metadata?: any;
+        namespace?: string;
     }): number;
     createEntitiesBatch(entities: CreateEntityInput[]): void;
     createRelation(fromName: string, toName: string, relationType: string, metadata?: any): void;
     getEntity(name: string): Entity | null;
     getRelations(entityName: string): Relation[];
     search(query?: string, opts?: SearchOptions): Entity[];
-    listRecent(limit?: number): Entity[];
-    deleteEntity(name: string): {
-        deleted: boolean;
+    trackAccess(entityIds: number[]): void;
+    findConflicts(entityNames: string[]): string[];
+    listRecent(limit?: number, includeArchived?: boolean, namespace?: string): Entity[];
+    private listRecentByTag;
+    archiveEntity(name: string): {
+        archived: boolean;
+        name?: string;
+        previousStatus?: string;
+    };
+    removeObservation(entityName: string, observationContent: string): {
+        removed: boolean;
+        remainingObservations: number;
     };
+    private deleteEntity;
     private rebuildFts;
 }
 //# sourceMappingURL=knowledge-graph.d.ts.map

package/dist/knowledge-graph.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"knowledge-graph.d.ts","sourceRoot":"","sources":["../src/knowledge-graph.ts"],"names":[],"mappings":"AAAA,OAAO,QAAQ,MAAM,gBAAgB,CAAC;AAEtC,MAAM,WAAW,MAAM;IACrB,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,UAAU,EAAE,MAAM,CAAC;IACnB,QAAQ,CAAC,EAAE,GAAG,CAAC;IACf,YAAY,EAAE,MAAM,EAAE,CAAC;IACvB,IAAI,EAAE,MAAM,EAAE,CAAC;IACf,SAAS,CAAC,EAAE,QAAQ,EAAE,CAAC;CACxB;AAED,MAAM,WAAW,QAAQ;IACvB,IAAI,EAAE,MAAM,CAAC;IACb,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,CAAC,EAAE,GAAG,CAAC;CAChB;AAED,MAAM,WAAW,iBAAiB;IAChC,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,YAAY,CAAC,EAAE,MAAM,EAAE,CAAC;IACxB,IAAI,CAAC,EAAE,MAAM,EAAE,CAAC;IAChB,QAAQ,CAAC,EAAE,GAAG,CAAC;CAChB;AAED,MAAM,WAAW,aAAa;IAC5B,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED,qBAAa,cAAc;IACb,OAAO,CAAC,EAAE;gBAAF,EAAE,EAAE,QAAQ,CAAC,QAAQ;IAEzC,YAAY,CACV,IAAI,EAAE,MAAM,EACZ,IAAI,EAAE,MAAM,EACZ,IAAI,CAAC,EAAE;QAAE,YAAY,CAAC,EAAE,MAAM,EAAE,CAAC;QAAC,IAAI,CAAC,EAAE,MAAM,EAAE,CAAC;QAAC,QAAQ,CAAC,EAAE,GAAG,CAAA;KAAE,GAClE,MAAM;IAmDT,mBAAmB,CAAC,QAAQ,EAAE,iBAAiB,EAAE,GAAG,IAAI;IAaxD,cAAc,CACZ,QAAQ,EAAE,MAAM,EAChB,MAAM,EAAE,MAAM,EACd,YAAY,EAAE,MAAM,EACpB,QAAQ,CAAC,EAAE,GAAG,GACb,IAAI;IA2BP,SAAS,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI;IA+BtC,YAAY,CAAC,UAAU,EAAE,MAAM,GAAG,QAAQ,EAAE;IAmB5C,MAAM,CAAC,KAAK,CAAC,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,aAAa,GAAG,MAAM,EAAE;IAgDtD,UAAU,CAAC,KAAK,CAAC,EAAE,MAAM,GAAG,MAAM,EAAE;IAUpC,YAAY,CAAC,IAAI,EAAE,MAAM,GAAG;QAAE,OAAO,EAAE,OAAO,CAAA;KAAE;IAyBhD,OAAO,CAAC,UAAU;CAsBnB"}
+{"version":3,"file":"knowledge-graph.d.ts","sourceRoot":"","sources":["../src/knowledge-graph.ts"],"names":[],"mappings":"AAAA,OAAO,QAAQ,MAAM,gBAAgB,CAAC;AACtC,YAAY,EAAE,MAAM,EAAE,QAAQ,EAAE,iBAAiB,EAAE,aAAa,EAAE,MAAM,iBAAiB,CAAC;AAC1F,OAAO,KAAK,EAAE,MAAM,EAAE,QAAQ,EAAE,iBAAiB,EAAE,aAAa,EAAE,MAAM,iBAAiB,CAAC;AAE1F,qBAAa,cAAc;IACb,OAAO,CAAC,EAAE;gBAAF,EAAE,EAAE,QAAQ,CAAC,QAAQ;IAEzC,YAAY,CACV,IAAI,EAAE,MAAM,EACZ,IAAI,EAAE,MAAM,EACZ,IAAI,CAAC,EAAE;QAAE,YAAY,CAAC,EAAE,MAAM,EAAE,CAAC;QAAC,IAAI,CAAC,EAAE,MAAM,EAAE,CAAC;QAAC,QAAQ,CAAC,EAAE,GAAG,CAAC;QAAC,SAAS,CAAC,EAAE,MAAM,CAAA;KAAE,GACtF,MAAM;IA6DT,mBAAmB,CAAC,QAAQ,EAAE,iBAAiB,EAAE,GAAG,IAAI;IAcxD,cAAc,CACZ,QAAQ,EAAE,MAAM,EAChB,MAAM,EAAE,MAAM,EACd,YAAY,EAAE,MAAM,EACpB,QAAQ,CAAC,EAAE,GAAG,GACb,IAAI;IA2BP,SAAS,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI;IAwCtC,YAAY,CAAC,UAAU,EAAE,MAAM,GAAG,QAAQ,EAAE;IAmB5C,MAAM,CAAC,KAAK,CAAC,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,aAAa,GAAG,MAAM,EAAE;IAiHtD,WAAW,CAAC,SAAS,EAAE,MAAM,EAAE,GAAG,IAAI;IAkBtC,aAAa,CAAC,WAAW,EAAE,MAAM,EAAE,GAAG,MAAM,EAAE;IAuB9C,UAAU,CAAC,KAAK,CAAC,EAAE,MAAM,EAAE,eAAe,CAAC,EAAE,OAAO,EAAE,SAAS,CAAC,EAAE,MAAM,GAAG,MAAM,EAAE;IAmBnF,OAAO,CAAC,eAAe;IA4BvB,aAAa,CAAC,IAAI,EAAE,MAAM,GAAG;QAAE,QAAQ,EAAE,OAAO,CAAC;QAAC,IAAI,CAAC,EAAE,MAAM,CAAC;QAAC,cAAc,CAAC,EAAE,MAAM,CAAA;KAAE;IA+B1F,iBAAiB,CACf,UAAU,EAAE,MAAM,EAClB,kBAAkB,EAAE,MAAM,GACzB;QAAE,OAAO,EAAE,OAAO,CAAC;QAAC,qBAAqB,EAAE,MAAM,CAAA;KAAE;IA8BtD,OAAO,CAAC,YAAY;IAyBpB,OAAO,CAAC,UAAU;CAsBnB"}

package/dist/knowledge-graph.js

@@ -5,19 +5,25 @@ export class KnowledgeGraph {
     }
     createEntity(name, type, opts) {
         const insertResult = this.db
-            .prepare('INSERT OR IGNORE INTO entities (name, type, metadata) VALUES (?, ?, ?)')
-            .run(name, type, opts?.metadata ? JSON.stringify(opts.metadata) : null);
+            .prepare('INSERT OR IGNORE INTO entities (name, type, metadata, namespace) VALUES (?, ?, ?, ?)')
+            .run(name, type, opts?.metadata ? JSON.stringify(opts.metadata) : null, opts?.namespace ?? 'personal');
         const isNewEntity = insertResult.changes > 0;
         const row = this.db
-            .prepare('SELECT id FROM entities WHERE name = ?')
+            .prepare('SELECT id, status FROM entities WHERE name = ?')
             .get(name);
         const entityId = row.id;
-        const prevObs = isNewEntity
+        const wasArchived = !isNewEntity && row.status === 'archived';
+        if (wasArchived) {
+            this.db
+                .prepare("UPDATE entities SET status = 'active' WHERE name = ?")
+                .run(name);
+        }
+        const prevObs = isNewEntity || wasArchived
             ? []
             : this.db
                 .prepare('SELECT content FROM observations WHERE entity_id = ?')
                 .all(entityId);
-        const prevObsText = isNewEntity
+        const prevObsText = isNewEntity || wasArchived
             ? undefined
             : prevObs.map((o) => o.content).join(' ');
         if (opts?.observations?.length) {
@@ -28,7 +34,7 @@ export class KnowledgeGraph {
         }
         this.rebuildFts(entityId, name, prevObsText);
         if (opts?.tags?.length) {
-            const insertTag = this.db.prepare('INSERT INTO tags (entity_id, tag) VALUES (?, ?)');
+            const insertTag = this.db.prepare('INSERT OR IGNORE INTO tags (entity_id, tag) VALUES (?, ?)');
             for (const tag of opts.tags) {
                 insertTag.run(entityId, tag);
             }
@@ -42,6 +48,7 @@ export class KnowledgeGraph {
                     observations: e.observations,
                     tags: e.tags,
                     metadata: e.metadata,
+                    namespace: e.namespace,
                 });
             }
         });
@@ -66,7 +73,7 @@ export class KnowledgeGraph {
     }
     getEntity(name) {
         const row = this.db
-            .prepare('SELECT id, name, type, created_at, metadata FROM entities WHERE name = ?')
+            .prepare('SELECT id, name, type, created_at, metadata, status, access_count, last_accessed_at, confidence, valid_from, valid_until, namespace FROM entities WHERE name = ?')
             .get(name);
         if (!row)
             return null;
@@ -88,6 +95,13 @@ export class KnowledgeGraph {
             observations,
             tags,
             relations: relations.length > 0 ? relations : undefined,
+            ...(row.status === 'archived' ? { archived: true } : {}),
+            access_count: row.access_count ?? 0,
+            last_accessed_at: row.last_accessed_at ?? undefined,
+            confidence: row.confidence ?? 1.0,
+            valid_from: row.valid_from ?? undefined,
+            valid_until: row.valid_until ?? undefined,
+            namespace: row.namespace ?? 'personal',
         };
     }
     getRelations(entityName) {
@@ -108,49 +122,216 @@ export class KnowledgeGraph {
     search(query, opts) {
         const limit = opts?.limit ?? 20;
         if (!query || query.trim() === '') {
-            return this.listRecent(limit);
+            if (opts?.tag) {
+                return this.listRecentByTag(opts.tag, limit, opts?.includeArchived, opts?.namespace);
+            }
+            return this.listRecent(limit, opts?.includeArchived, opts?.namespace);
         }
         const sanitized = query.replace(/"/g, '""').trim();
         const tokens = sanitized.split(/\s+/).filter((t) => t.length > 0);
         if (tokens.length === 0)
-            return this.listRecent(limit);
+            return this.listRecent(limit, opts?.includeArchived, opts?.namespace);
         const ftsQuery = tokens.map((token) => `"${token}"`).join(' ');
+        const statusFilter = opts?.includeArchived ? '' : "AND e.status = 'active'";
+        const namespaceFilter = opts?.namespace ? 'AND e.namespace = ?' : '';
         let ftsRows;
         try {
-            ftsRows = this.db
-                .prepare(`SELECT e.name FROM entities_fts f
-           JOIN entities e ON e.id = f.rowid
-           WHERE entities_fts MATCH ?
-           LIMIT ?`)
-                .all(ftsQuery, limit);
+            if (opts?.tag) {
+                const params = [ftsQuery, opts.tag];
+                if (opts?.namespace)
+                    params.push(opts.namespace);
+                params.push(limit);
+                ftsRows = this.db
+                    .prepare(`SELECT DISTINCT e.id, e.name FROM entities_fts f
+             JOIN entities e ON e.id = f.rowid
+             JOIN tags t ON t.entity_id = e.id
+             WHERE entities_fts MATCH ?
+               AND t.tag = ?
+               ${statusFilter}
+               ${namespaceFilter}
+             ORDER BY e.id DESC
+             LIMIT ?`)
+                    .all(...params);
+            }
+            else {
+                const params = [ftsQuery];
+                if (opts?.namespace)
+                    params.push(opts.namespace);
+                params.push(limit);
+                ftsRows = this.db
+                    .prepare(`SELECT e.id, e.name FROM entities_fts f
+             JOIN entities e ON e.id = f.rowid
+             WHERE entities_fts MATCH ?
+               ${statusFilter}
+               ${namespaceFilter}
+             ORDER BY e.id DESC
+             LIMIT ?`)
+                    .all(...params);
+            }
         }
         catch (err) {
             if (err.message?.includes('fts5'))
                 return [];
             throw err;
         }
-        if (ftsRows.length === 0)
-            return [];
         const results = [];
+        const seenIds = new Set();
         for (const ftsRow of ftsRows) {
             const entity = this.getEntity(ftsRow.name);
             if (!entity)
                 continue;
-            if (opts?.tag) {
-                if (!entity.tags.includes(opts.tag))
+            seenIds.add(ftsRow.id);
+            results.push(entity);
+        }
+        if (opts?.includeArchived) {
+            const tagJoin = opts?.tag ? 'JOIN tags t ON t.entity_id = e.id' : '';
+            const tagFilter = opts?.tag ? 'AND t.tag = ?' : '';
+            const archivedNamespaceFilter = opts?.namespace ? 'AND e.namespace = ?' : '';
+            const archivedParams = [`%${query}%`, `%${query}%`];
+            if (opts?.tag)
+                archivedParams.push(opts.tag);
+            if (opts?.namespace)
+                archivedParams.push(opts.namespace);
+            const archivedRows = this.db
+                .prepare(`SELECT DISTINCT e.id, e.name
+           FROM entities e
+           LEFT JOIN observations o ON o.entity_id = e.id
+           ${tagJoin}
+           WHERE e.status = 'archived'
+             AND (e.name LIKE ? OR o.content LIKE ?)
+             ${tagFilter}
+             ${archivedNamespaceFilter}
+           ORDER BY e.id DESC
+           LIMIT ?`)
+                .all(...archivedParams, limit);
+            for (const row of archivedRows) {
+                if (seenIds.has(row.id))
+                    continue;
+                const entity = this.getEntity(row.name);
+                if (!entity)
                     continue;
+                results.push(entity);
             }
-            results.push(entity);
         }
+        const entityIds = results.map((e) => e.id);
+        this.trackAccess(entityIds);
         return results;
     }
-    listRecent(limit) {
+    trackAccess(entityIds) {
+        if (entityIds.length === 0)
+            return;
+        const now = new Date().toISOString();
+        const stmt = this.db.prepare('UPDATE entities SET access_count = access_count + 1, last_accessed_at = ? WHERE id = ?');
+        const txn = this.db.transaction(() => {
+            for (const id of entityIds) {
+                stmt.run(now, id);
+            }
+        });
+        txn();
+    }
+    findConflicts(entityNames) {
+        if (entityNames.length < 2)
+            return [];
+        const conflicts = [];
+        const placeholders = entityNames.map(() => '?').join(',');
+        const rows = this.db.prepare(`
+      SELECT e_from.name AS from_name, e_to.name AS to_name
+      FROM relations r
+      JOIN entities e_from ON r.from_entity_id = e_from.id
+      JOIN entities e_to ON r.to_entity_id = e_to.id
+      WHERE r.relation_type = 'contradicts'
+        AND e_from.name IN (${placeholders})
+        AND e_to.name IN (${placeholders})
+    `).all(...entityNames, ...entityNames);
+        for (const row of rows) {
+            conflicts.push(`"${row.from_name}" contradicts "${row.to_name}"`);
+        }
+        return conflicts;
+    }
+    listRecent(limit, includeArchived, namespace) {
+        const statusFilter = includeArchived ? '' : "AND status = 'active'";
+        const namespaceFilter = namespace ? 'AND namespace = ?' : '';
+        const params = [];
+        if (namespace)
+            params.push(namespace);
+        params.push(limit ?? 20);
         const rows = this.db
-            .prepare('SELECT name FROM entities ORDER BY id DESC LIMIT ?')
-            .all(limit ?? 20);
-        return rows
+            .prepare(`SELECT name FROM entities WHERE 1=1 ${statusFilter} ${namespaceFilter} ORDER BY id DESC LIMIT ?`)
+            .all(...params);
+        const results = rows
             .map((r) => this.getEntity(r.name))
             .filter((e) => e !== null);
+        const entityIds = results.map((e) => e.id);
+        this.trackAccess(entityIds);
+        return results;
+    }
+    listRecentByTag(tag, limit, includeArchived, namespace) {
+        const statusFilter = includeArchived ? '' : "AND e.status = 'active'";
+        const namespaceFilter = namespace ? 'AND e.namespace = ?' : '';
+        const params = [tag];
+        if (namespace)
+            params.push(namespace);
+        params.push(limit);
+        const rows = this.db
+            .prepare(`SELECT DISTINCT e.name
+         FROM entities e
+         JOIN tags t ON t.entity_id = e.id
+         WHERE t.tag = ?
+         ${statusFilter}
+         ${namespaceFilter}
+         ORDER BY e.id DESC
+         LIMIT ?`)
+            .all(...params);
+        const results = rows
+            .map((r) => this.getEntity(r.name))
+            .filter((e) => e !== null);
+        const entityIds = results.map((e) => e.id);
+        this.trackAccess(entityIds);
+        return results;
+    }
+    archiveEntity(name) {
+        const row = this.db
+            .prepare('SELECT id, status FROM entities WHERE name = ?')
+            .get(name);
+        if (!row)
+            return { archived: false };
+        const allObs = this.db
+            .prepare('SELECT content FROM observations WHERE entity_id = ?')
+            .all(row.id);
+        const obsText = allObs.map((o) => o.content).join(' ');
+        try {
+            this.db
+                .prepare("INSERT INTO entities_fts (entities_fts, rowid, name, observations) VALUES('delete', ?, ?, ?)")
+                .run(row.id, name, obsText);
+        }
+        catch {
+        }
+        this.db
+            .prepare("UPDATE entities SET status = 'archived' WHERE id = ?")
+            .run(row.id);
+        return { archived: true, name, previousStatus: row.status };
+    }
+    removeObservation(entityName, observationContent) {
+        const row = this.db
+            .prepare('SELECT id FROM entities WHERE name = ?')
+            .get(entityName);
+        if (!row)
+            return { removed: false, remainingObservations: 0 };
+        const prevObs = this.db
+            .prepare('SELECT content FROM observations WHERE entity_id = ?')
+            .all(row.id);
+        const prevObsText = prevObs.map((o) => o.content).join(' ');
+        const deleteResult = this.db
+            .prepare('DELETE FROM observations WHERE entity_id = ? AND content = ?')
+            .run(row.id, observationContent);
+        if (deleteResult.changes === 0) {
+            return { removed: false, remainingObservations: prevObs.length };
+        }
+        this.rebuildFts(row.id, entityName, prevObsText);
+        const remaining = this.db
+            .prepare('SELECT COUNT(*) as c FROM observations WHERE entity_id = ?')
+            .get(row.id);
+        return { removed: true, remainingObservations: remaining.c };
     }
     deleteEntity(name) {
         const row = this.db