squish-memory 1.1.5 → 1.2.1

package/dist/core/memory/write-gate.js

@@ -1,210 +0,0 @@
-/**
- * Write Gate Enforcement
- * Validates memories before writing to ensure quality, security, and consistency
- * Integrates secret detection, trigger detection, and content validation
- */
-import { detectSecrets, redactSecrets } from '../security/secret-detector.js';
-import { detectMemorySignals } from './trigger-detector.js';
-import { resolveContradictions } from './contradiction-resolver.js';
-import { logger } from '../logger.js';
-const DEFAULT_OPTIONS = {
-    allowSecrets: false,
-    minContentLength: 5,
-    maxContentLength: 50000,
-    skipContradictionCheck: false,
-    skipTemporalSupersession: false,
-};
-/**
- * Main write gate function - validates and sanitizes content before write
- */
-export async function enforceWriteGate(content, type, options = {}) {
-    const opts = { ...DEFAULT_OPTIONS, ...options };
-    const result = {
-        allowed: true,
-        sanitized: false,
-        warnings: [],
-        errors: [],
-        metadata: {
-            secretsDetected: 0,
-            signals: null,
-            contradictions: { found: false, count: 0 },
-            temporalSupersession: { count: 0 },
-        },
-    };
-    let processedContent = content;
-    // 1. Content length validation
-    if (content.length < opts.minContentLength) {
-        result.errors.push(`Content too short (min ${opts.minContentLength} characters)`);
-        result.allowed = false;
-        return result;
-    }
-    if (content.length > opts.maxContentLength) {
-        result.errors.push(`Content too long (max ${opts.maxContentLength} characters)`);
-        result.allowed = false;
-        return result;
-    }
-    // 2. Secret detection
-    const secrets = detectSecrets(content, 'high');
-    result.metadata.secretsDetected = secrets.length;
-    if (secrets.length > 0) {
-        const secretTypes = [...new Set(secrets.map(s => s.type))];
-        if (!opts.allowSecrets) {
-            result.errors.push(`Potential secrets detected: ${secretTypes.join(', ')}`);
-            result.warnings.push('Content contains sensitive data that must be redacted');
-            result.allowed = false;
-            return result;
-        }
-        else {
-            // Redact secrets but allow write
-            processedContent = redactSecrets(content);
-            result.sanitized = true;
-            result.sanitizedContent = processedContent;
-            result.warnings.push(`Redacted ${secrets.length} potential secrets: ${secretTypes.join(', ')}`);
-        }
-    }
-    // 3. Memory signals detection
-    const signals = detectMemorySignals(content);
-    result.metadata.signals = signals;
-    // Add warnings for high-priority signals
-    if (signals.priority === 'high') {
-        result.warnings.push('High-priority memory signal detected');
-    }
-    if (signals.implicit.correction) {
-        result.warnings.push('Content appears to be a correction - contradiction check recommended');
-    }
-    // 4. Contradiction detection (async, non-blocking for write)
-    if (!opts.skipContradictionCheck && signals.implicit.correction) {
-        try {
-            const contradictionResult = await resolveContradictions(processedContent, type, opts.projectId);
-            result.metadata.contradictions = {
-                found: contradictionResult.supersededIds.length > 0,
-                count: contradictionResult.supersededIds.length,
-            };
-            if (contradictionResult.supersededIds.length > 0) {
-                result.warnings.push(`This memory supersedes ${contradictionResult.supersededIds.length} older memories`);
-            }
-        }
-        catch (error) {
-            logger.error('Contradiction check failed', error);
-            result.warnings.push('Contradiction check failed - proceeding with write');
-        }
-    }
-    // 5. Temporal fact handling
-    if (!opts.skipTemporalSupersession) {
-        try {
-            // This would be done after the memory is actually written, but we note it here
-            result.metadata.temporalSupersession = { count: 0 };
-        }
-        catch (error) {
-            logger.error('Temporal check failed', error);
-        }
-    }
-    // 6. Content quality checks
-    const qualityIssues = checkContentQuality(processedContent);
-    result.warnings.push(...qualityIssues);
-    return result;
-}
-/**
- * Quick validation without async operations
- * Use for fast pre-check before full validation
- */
-export function quickValidate(content) {
-    const errors = [];
-    // Check for empty or whitespace-only content
-    if (!content || content.trim().length === 0) {
-        errors.push('Content is empty');
-        return { valid: false, errors };
-    }
-    // Check for minimum length
-    if (content.trim().length < 5) {
-        errors.push('Content is too short');
-    }
-    // Check for obvious secrets (high confidence only)
-    const secrets = detectSecrets(content, 'high');
-    if (secrets.length > 0) {
-        errors.push(`Content contains ${secrets.length} potential secrets`);
-    }
-    return { valid: errors.length === 0, errors };
-}
-/**
- * Check content quality and return warnings
- */
-function checkContentQuality(content) {
-    const warnings = [];
-    // Check for excessive repetition
-    const words = content.toLowerCase().split(/\s+/);
-    const wordCounts = new Map();
-    for (const word of words) {
-        if (word.length > 3) { // Only check meaningful words
-            wordCounts.set(word, (wordCounts.get(word) || 0) + 1);
-        }
-    }
-    for (const [word, count] of wordCounts.entries()) {
-        if (count > 10) {
-            warnings.push(`Excessive repetition detected: "${word}" appears ${count} times`);
-            break; // Only report one
-        }
-    }
-    // Check for very long lines (might be code or minified content)
-    const lines = content.split('\n');
-    for (const line of lines) {
-        if (line.length > 1000) {
-            warnings.push('Content contains very long lines - may not be human-readable');
-            break;
-        }
-    }
-    // Check for binary-like content
-    const binaryPattern = /[\x00-\x08\x0E-\x1F]/;
-    if (binaryPattern.test(content)) {
-        warnings.push('Content may contain binary data');
-    }
-    return warnings;
-}
-/**
- * Sanitize content for storage
- * Redacts secrets and normalizes whitespace
- */
-export function sanitizeForStorage(content) {
-    // Redact secrets
-    let sanitized = redactSecrets(content);
-    // Normalize excessive whitespace
-    sanitized = sanitized.replace(/\n{3,}/g, '\n\n');
-    sanitized = sanitized.replace(/ {2,}/g, ' ');
-    // Trim
-    sanitized = sanitized.trim();
-    return sanitized;
-}
-/**
- * Calculate a quality score for content (0-100)
- */
-export function calculateContentQualityScore(content) {
-    let score = 100;
-    // Deduct for short content
-    if (content.length < 20) {
-        score -= 30;
-    }
-    else if (content.length < 50) {
-        score -= 15;
-    }
-    // Deduct for secrets
-    const secrets = detectSecrets(content, 'high');
-    score -= secrets.length * 20;
-    // Deduct for repetition
-    const words = content.toLowerCase().split(/\s+/);
-    const uniqueWords = new Set(words.filter(w => w.length > 3));
-    const repetitionRatio = uniqueWords.size / Math.max(1, words.length);
-    if (repetitionRatio < 0.3) {
-        score -= 20;
-    }
-    // Bonus for structure (sentences, punctuation)
-    const sentences = content.split(/[.!?]+/).filter(s => s.trim().length > 0);
-    if (sentences.length > 1) {
-        score += 10;
-    }
-    // Bonus for reasonable length
-    if (content.length >= 50 && content.length <= 2000) {
-        score += 5;
-    }
-    return Math.max(0, Math.min(100, score));
-}
-//# sourceMappingURL=write-gate.js.map

package/dist/core/namespaces/index.d.ts

@@ -1,71 +0,0 @@
-/** Namespace Management - Hierarchical folder-like namespaces for memories */
-export type NamespaceType = 'root' | 'user' | 'agent' | 'project' | 'custom';
-export interface Namespace {
-    id: string;
-    projectId: string;
-    name: string;
-    parentId: string | null;
-    type: NamespaceType;
-    description: string | null;
-    path: string;
-    children?: Namespace[];
-    createdAt: Date;
-    updatedAt: Date;
-}
-export interface NamespaceCreateInput {
-    projectId: string;
-    name: string;
-    type: NamespaceType;
-    parentId?: string | null;
-    description?: string;
-}
-export interface NamespaceTree {
-    id: string;
-    name: string;
-    type: NamespaceType;
-    description: string | null;
-    path: string;
-    children: NamespaceTree[];
-}
-/**
- * Create a new namespace
- */
-export declare function createNamespace(input: NamespaceCreateInput): Promise<Namespace>;
-/**
- * Get a namespace by ID
- */
-export declare function getNamespaceById(id: string): Promise<Namespace | null>;
-/**
- * Resolve a namespace path to a namespace ID
- * @example resolveNamespacePath('my-project', ['user', 'preferences']) -> namespaceId
- */
-export declare function resolveNamespacePath(projectId: string, path: string[]): Promise<string | null>;
-/**
- * Get namespace tree for a project
- */
-export declare function getNamespaceTree(projectId: string): Promise<NamespaceTree[]>;
-/**
- * Get or create default namespaces for a project
- */
-export declare function getDefaultNamespaces(projectId: string): Promise<Namespace[]>;
-/**
- * List namespaces with optional filtering
- */
-export declare function listNamespaces(options?: {
-    projectId?: string;
-    type?: NamespaceType;
-    parentId?: string;
-    recursive?: boolean;
-}): Promise<Namespace[]>;
-/**
- * Delete a namespace (cascades to child namespaces)
- */
-export declare function deleteNamespace(id: string): Promise<void>;
-/**
- * Update namespace
- */
-export declare function updateNamespace(id: string, updates: Partial<{
-    name: string;
-    description: string;
-}>): Promise<void>;
-//# sourceMappingURL=index.d.ts.map

package/dist/core/namespaces/index.js

@@ -1,305 +0,0 @@
-/** Namespace Management - Hierarchical folder-like namespaces for memories */
-import { randomUUID } from 'crypto';
-import { eq, and, isNull } from 'drizzle-orm';
-import { getDb } from '../../db/index.js';
-import { getSchema } from '../../db/schema.js';
-import { logger } from '../logger.js';
-/**
- * Create a new namespace
- */
-export async function createNamespace(input) {
-    const db = await getDb();
-    if (!db) {
-        throw new Error('Database unavailable');
-    }
-    const schema = await getSchema();
-    const id = randomUUID();
-    // Check if namespace with same name exists under parent
-    const sqliteDb = db;
-    const existing = await sqliteDb.select()
-        .from(schema.namespaces)
-        .where(and(eq(schema.namespaces.projectId, input.projectId), eq(schema.namespaces.name, input.name), input.parentId
-        ? eq(schema.namespaces.parentId, input.parentId)
-        : isNull(schema.namespaces.parentId)))
-        .limit(1);
-    if (existing.length > 0) {
-        throw new Error(`Namespace "${input.name}" already exists under ${input.parentId || 'root'}`);
-    }
-    // Build namespace path
-    const path = await buildNamespacePath(input.projectId, input.name, input.parentId ?? null);
-    await sqliteDb.insert(schema.namespaces).values({
-        id,
-        projectId: input.projectId,
-        name: input.name,
-        type: input.type,
-        parentId: input.parentId || null,
-        description: input.description || null,
-        createdAt: new Date(),
-        updatedAt: new Date(),
-    });
-    logger.info(`[Namespaces] Created namespace: ${path}`);
-    return {
-        id,
-        projectId: input.projectId,
-        name: input.name,
-        type: input.type,
-        parentId: input.parentId || null,
-        description: input.description || null,
-        path,
-        createdAt: new Date(),
-        updatedAt: new Date(),
-    };
-}
-/**
- * Build full namespace path from parent
- */
-async function buildNamespacePath(projectId, name, parentId) {
-    if (!parentId) {
-        return name;
-    }
-    const db = await getDb();
-    const schema = await getSchema();
-    const sqliteDb = db;
-    const [parent] = await sqliteDb.select()
-        .from(schema.namespaces)
-        .where(eq(schema.namespaces.id, parentId))
-        .limit(1);
-    if (!parent) {
-        return name;
-    }
-    return `${parent.path}/${name}`;
-}
-/**
- * Get a namespace by ID
- */
-export async function getNamespaceById(id) {
-    const db = await getDb();
-    if (!db)
-        return null;
-    const schema = await getSchema();
-    const sqliteDb = db;
-    const [row] = await sqliteDb.select()
-        .from(schema.namespaces)
-        .where(eq(schema.namespaces.id, id))
-        .limit(1);
-    if (!row)
-        return null;
-    return {
-        id: row.id,
-        projectId: row.projectId,
-        name: row.name,
-        type: row.type,
-        parentId: row.parentId,
-        description: row.description,
-        path: row.path,
-        createdAt: new Date(row.createdAt),
-        updatedAt: new Date(row.updatedAt),
-    };
-}
-/**
- * Resolve a namespace path to a namespace ID
- * @example resolveNamespacePath('my-project', ['user', 'preferences']) -> namespaceId
- */
-export async function resolveNamespacePath(projectId, path) {
-    if (path.length === 0)
-        return null;
-    const db = await getDb();
-    if (!db)
-        return null;
-    const schema = await getSchema();
-    const sqliteDb = db;
-    let parentId = null;
-    let targetNamespace = null;
-    // Traverse path segments
-    for (const segment of path) {
-        const [result] = await sqliteDb.select()
-            .from(schema.namespaces)
-            .where(and(eq(schema.namespaces.projectId, projectId), eq(schema.namespaces.name, segment), parentId
-            ? eq(schema.namespaces.parentId, parentId)
-            : isNull(schema.namespaces.parentId)))
-            .limit(1);
-        if (!result)
-            return null;
-        targetNamespace = result;
-        parentId = result.id;
-    }
-    return targetNamespace?.id || null;
-}
-/**
- * Get namespace tree for a project
- */
-export async function getNamespaceTree(projectId) {
-    const db = await getDb();
-    if (!db)
-        return [];
-    const schema = await getSchema();
-    const sqliteDb = db;
-    // Get all namespaces for project
-    const all = await sqliteDb.select()
-        .from(schema.namespaces)
-        .where(eq(schema.namespaces.projectId, projectId))
-        .orderBy(schema.namespaces.name);
-    // Build tree structure
-    const map = new Map();
-    const roots = [];
-    for (const row of all) {
-        const node = {
-            id: row.id,
-            name: row.name,
-            type: row.type,
-            description: row.description,
-            path: row.path,
-            children: [],
-        };
-        map.set(row.id, node);
-        if (!row.parentId) {
-            roots.push(node);
-        }
-        else {
-            const parent = map.get(row.parentId);
-            if (parent) {
-                parent.children.push(node);
-            }
-        }
-    }
-    return roots;
-}
-/**
- * Get or create default namespaces for a project
- */
-export async function getDefaultNamespaces(projectId) {
-    const db = await getDb();
-    if (!db)
-        return [];
-    const schema = await getSchema();
-    const sqliteDb = db;
-    const created = [];
-    const defaults = [
-        { name: 'user', type: 'user', description: 'User-specific memories and preferences' },
-        { name: 'agent', type: 'agent', description: 'Agent-specific knowledge and state' },
-        { name: 'project', type: 'project', description: 'Project-specific decisions and context' },
-    ];
-    const defaultNames = ['user', 'agent', 'project'];
-    // Check all default namespaces at once with IN clause
-    const existing = await sqliteDb.select()
-        .from(schema.namespaces)
-        .where(and(eq(schema.namespaces.projectId, projectId), eq(schema.namespaces.name, defaultNames[0]), eq(schema.namespaces.type, 'user'), isNull(schema.namespaces.parentId)));
-    if (existing.length > 0) {
-        const ns = await createNamespace({
-            projectId,
-            name: defaultNames[0],
-            type: 'user',
-            parentId: null,
-        });
-        created.push({
-            id: ns.id,
-            projectId: ns.projectId,
-            name: ns.name,
-            type: ns.type,
-            parentId: ns.parentId,
-            description: ns.description,
-            path: ns.path,
-            createdAt: new Date(ns.createdAt),
-            updatedAt: new Date(ns.updatedAt),
-        });
-    }
-    // Check remaining defaults sequentially (agent and project)
-    for (const defName of defaultNames.slice(1)) {
-        const existing = await sqliteDb.select()
-            .from(schema.namespaces)
-            .where(and(eq(schema.namespaces.projectId, projectId), eq(schema.namespaces.name, defName), eq(schema.namespaces.type, defName), isNull(schema.namespaces.parentId)))
-            .limit(1);
-        if (existing.length === 0) {
-            const ns = await createNamespace({
-                projectId,
-                name: defName,
-                type: defName === 'agent' ? 'agent' : 'project',
-                parentId: null,
-            });
-            created.push(ns);
-        }
-        else {
-            created.push({
-                id: existing[0].id,
-                projectId: existing[0].projectId,
-                name: existing[0].name,
-                type: existing[0].type,
-                parentId: existing[0].parentId,
-                description: existing[0].description,
-                path: existing[0].path,
-                createdAt: new Date(existing[0].createdAt),
-                updatedAt: new Date(existing[0].updatedAt),
-            });
-        }
-    }
-    logger.info(`[Namespaces] Default namespaces ready for project: ${projectId}`);
-    return created;
-}
-/**
- * List namespaces with optional filtering
- */
-export async function listNamespaces(options = {}) {
-    const db = await getDb();
-    if (!db)
-        return [];
-    const schema = await getSchema();
-    const sqliteDb = db;
-    const conditions = [];
-    if (options.projectId) {
-        conditions.push(eq(schema.namespaces.projectId, options.projectId));
-    }
-    if (options.type) {
-        conditions.push(eq(schema.namespaces.type, options.type));
-    }
-    if (options.parentId !== undefined) {
-        if (options.parentId === null) {
-            conditions.push(isNull(schema.namespaces.parentId));
-        }
-        else {
-            conditions.push(eq(schema.namespaces.parentId, options.parentId));
-        }
-    }
-    const rows = await sqliteDb.select()
-        .from(schema.namespaces)
-        .where(conditions.length > 0 ? and(...conditions) : undefined)
-        .orderBy(schema.namespaces.name);
-    return rows.map((row) => ({
-        id: row.id,
-        projectId: row.projectId,
-        name: row.name,
-        type: row.type,
-        parentId: row.parentId,
-        description: row.description,
-        path: row.path,
-        createdAt: new Date(row.createdAt),
-        updatedAt: new Date(row.updatedAt),
-    }));
-}
-/**
- * Delete a namespace (cascades to child namespaces)
- */
-export async function deleteNamespace(id) {
-    const db = await getDb();
-    if (!db)
-        return;
-    const schema = await getSchema();
-    const sqliteDb = db;
-    await sqliteDb.delete(schema.namespaces).where(eq(schema.namespaces.id, id));
-    logger.info(`[Namespaces] Deleted namespace: ${id}`);
-}
-/**
- * Update namespace
- */
-export async function updateNamespace(id, updates) {
-    const db = await getDb();
-    if (!db)
-        return;
-    const schema = await getSchema();
-    const sqliteDb = db;
-    await sqliteDb.update(schema.namespaces).set({
-        ...updates,
-        updatedAt: new Date(),
-    }).where(eq(schema.namespaces.id, id));
-    logger.info(`[Namespaces] Updated namespace: ${id}`);
-}
-//# sourceMappingURL=index.js.map

package/dist/core/namespaces/uri-parser.d.ts

@@ -1,31 +0,0 @@
-/** URI Parser for Squish namespace scheme (squish://) */
-export interface SquishURIParsed {
-    type: 'namespace';
-    projectId: string;
-    namespacePath: string[];
-    memoryId?: string;
-}
-/**
- * Parse a squish:// URI into components
- * @example parseSquishURI('squish://my-project/user/preferences') -> { type: 'namespace', projectId: 'my-project', namespacePath: ['user', 'preferences'] }
- */
-export declare function parseSquishURI(uri: string): SquishURIParsed | null;
-/**
- * Build a squish:// URI from components
- * @example buildSquishURI('my-project', ['user', 'preferences']) -> 'squish://my-project/user/preferences'
- */
-export declare function buildSquishURI(projectId: string, path: string[], memoryId?: string): string;
-/**
- * Validate a namespace path (no "..", no empty segments)
- */
-export declare function validateNamespacePath(path: string[]): boolean;
-/**
- * Get parent namespace path
- * @example getParentPath(['user', 'preferences', 'coding']) -> ['user', 'preferences']
- */
-export declare function getParentPath(path: string[]): string[] | null;
-/**
- * Join namespace path segments
- */
-export declare function joinNamespacePath(...segments: (string | string[])[]): string[];
-//# sourceMappingURL=uri-parser.d.ts.map

package/dist/core/namespaces/uri-parser.js

@@ -1,74 +0,0 @@
-/** URI Parser for Squish namespace scheme (squish://) */
-/**
- * Parse a squish:// URI into components
- * @example parseSquishURI('squish://my-project/user/preferences') -> { type: 'namespace', projectId: 'my-project', namespacePath: ['user', 'preferences'] }
- */
-export function parseSquishURI(uri) {
-    if (!uri || typeof uri !== 'string') {
-        return null;
-    }
-    // Match squish://project/path/to/memory
-    const match = uri.match(/^squish:\/\/([^\/]+)\/(.*)$/);
-    if (!match) {
-        return null;
-    }
-    const [, projectId, pathPart] = match;
-    const namespacePath = pathPart ? pathPart.split('/').filter(Boolean) : [];
-    // If path ends with a UUID, it's a memory ID
-    const lastSegment = namespacePath[namespacePath.length - 1];
-    let memoryId;
-    if (lastSegment && /^[a-f0-9]{8}-[a-f0-9]{4}-[a-f0-9]{4}-[a-f0-9]{4}-[a-f0-9]{12}$/.test(lastSegment)) {
-        memoryId = lastSegment;
-        namespacePath.pop();
-    }
-    return {
-        type: 'namespace',
-        projectId,
-        namespacePath,
-        memoryId,
-    };
-}
-/**
- * Build a squish:// URI from components
- * @example buildSquishURI('my-project', ['user', 'preferences']) -> 'squish://my-project/user/preferences'
- */
-export function buildSquishURI(projectId, path, memoryId) {
-    if (!projectId) {
-        throw new Error('Project ID is required');
-    }
-    const cleanPath = path.filter(Boolean);
-    const basePath = `squish://${projectId}${cleanPath.length > 0 ? '/' + cleanPath.join('/') : ''}`;
-    return memoryId ? `${basePath}/${memoryId}` : basePath;
-}
-/**
- * Validate a namespace path (no "..", no empty segments)
- */
-export function validateNamespacePath(path) {
-    if (path.length === 0)
-        return true;
-    for (const segment of path) {
-        if (!segment || segment.length === 0) {
-            return false;
-        }
-        if (segment.includes('..')) {
-            return false;
-        }
-    }
-    return true;
-}
-/**
- * Get parent namespace path
- * @example getParentPath(['user', 'preferences', 'coding']) -> ['user', 'preferences']
- */
-export function getParentPath(path) {
-    if (path.length <= 1)
-        return null;
-    return path.slice(0, -1);
-}
-/**
- * Join namespace path segments
- */
-export function joinNamespacePath(...segments) {
-    return segments.flat().filter(Boolean);
-}
-//# sourceMappingURL=uri-parser.js.map