fivocell 5.4.0 → 6.0.0

package/dist/walls/06-memory/database/validation.d.ts

@@ -0,0 +1,12 @@
+export interface ValidationError {
+    field: string;
+    message: string;
+    value?: unknown;
+}
+export declare function validateEventType(type: string): string | null;
+export declare function validateImportance(importance: number): string | null;
+export declare function validateProjectName(name: string): string | null;
+export declare function validateSummary(summary: string): string | null;
+export declare function validateMemoryEvent(event: Record<string, unknown>): ValidationError[];
+export declare function sanitizeString(input: string, maxLength?: number): string;
+//# sourceMappingURL=validation.d.ts.map

package/dist/walls/06-memory/database/validation.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"validation.d.ts","sourceRoot":"","sources":["../../../../src/walls/06-memory/database/validation.ts"],"names":[],"mappings":"AAUA,MAAM,WAAW,eAAe;IAC9B,KAAK,EAAE,MAAM,CAAC;IACd,OAAO,EAAE,MAAM,CAAC;IAChB,KAAK,CAAC,EAAE,OAAO,CAAC;CACjB;AAED,wBAAgB,iBAAiB,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAM7D;AAED,wBAAgB,kBAAkB,CAAC,UAAU,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CASpE;AAED,wBAAgB,mBAAmB,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAK/D;AAED,wBAAgB,eAAe,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAI9D;AAED,wBAAgB,mBAAmB,CAAC,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,eAAe,EAAE,CAgBrF;AAED,wBAAgB,cAAc,CAAC,KAAK,EAAE,MAAM,EAAE,SAAS,GAAE,MAAa,GAAG,MAAM,CAG9E"}

package/dist/walls/06-memory/database/validation.js

@@ -0,0 +1,73 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.validateEventType = validateEventType;
+exports.validateImportance = validateImportance;
+exports.validateProjectName = validateProjectName;
+exports.validateSummary = validateSummary;
+exports.validateMemoryEvent = validateMemoryEvent;
+exports.sanitizeString = sanitizeString;
+const VALID_EVENT_TYPES = [
+    'file_event', 'edit', 'decision', 'error', 'fix',
+    'verification', 'publish', 'handoff', 'pattern', 'style',
+    'session', 'branch', 'risk', 'question', 'ai_work',
+];
+const VALID_CI_STATUSES = ['success', 'failure', 'cancelled', 'failed', 'rolled_back'];
+const VALID_MEMORY_IMPORTANCE = [1, 2, 3, 4, 5, 6, 7, 8, 9, 10];
+const VALID_SYNC_STRATEGIES = ['local-wins', 'remote-wins', 'importance', 'timestamp'];
+function validateEventType(type) {
+    if (!type)
+        return 'Event type is required';
+    if (!VALID_EVENT_TYPES.includes(type)) {
+        return `Invalid event type: "${type}". Valid: ${VALID_EVENT_TYPES.join(', ')}`;
+    }
+    return null;
+}
+function validateImportance(importance) {
+    if (importance == null)
+        return null; // optional, defaults to 3
+    if (typeof importance !== 'number' || !Number.isInteger(importance)) {
+        return 'Importance must be an integer';
+    }
+    if (importance < 1 || importance > 10) {
+        return 'Importance must be between 1 and 10';
+    }
+    return null;
+}
+function validateProjectName(name) {
+    if (!name || typeof name !== 'string')
+        return 'Project name is required';
+    if (name.length > 200)
+        return 'Project name must be 200 characters or less';
+    if (/[<>:"/\\|?*\x00-\x1f]/.test(name))
+        return 'Project name contains invalid characters';
+    return null;
+}
+function validateSummary(summary) {
+    if (!summary || typeof summary !== 'string')
+        return 'Summary is required';
+    if (summary.length > 2000)
+        return 'Summary must be 2000 characters or less';
+    return null;
+}
+function validateMemoryEvent(event) {
+    const errors = [];
+    const typeErr = validateEventType(event.type);
+    if (typeErr)
+        errors.push({ field: 'type', message: typeErr, value: event.type });
+    const projErr = validateProjectName(event.project);
+    if (projErr)
+        errors.push({ field: 'project', message: projErr, value: event.project });
+    const sumErr = validateSummary(event.summary);
+    if (sumErr)
+        errors.push({ field: 'summary', message: sumErr, value: event.summary });
+    const impErr = validateImportance(event.importance);
+    if (impErr)
+        errors.push({ field: 'importance', message: impErr, value: event.importance });
+    return errors;
+}
+function sanitizeString(input, maxLength = 2000) {
+    if (typeof input !== 'string')
+        return '';
+    return input.replace(/[\x00-\x08\x0B\x0C\x0E-\x1F]/g, '').trim().slice(0, maxLength);
+}
+//# sourceMappingURL=validation.js.map

package/dist/walls/06-memory/database/validation.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"validation.js","sourceRoot":"","sources":["../../../../src/walls/06-memory/database/validation.ts"],"names":[],"mappings":"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"}

package/dist/walls/07-runtime/cli/cli.js

@@ -211,6 +211,13 @@ switch (cmd) {
     case 'dash':
         doDashboard();
         break;
+    case 'perf':
+    case 'performance':
+        doPerf();
+        break;
+    case 'migrate':
+        doMigrate();
+        break;
     case 'cross-project':
         doCrossProject();
         break;
@@ -3129,6 +3136,8 @@ function doHelp() {
     console.log(`  ${C.primary('cell memory')}         Search/timeline/compact/verify/export memory`);
     console.log(`  ${C.primary('cell cross-project')}  Share/list/insights from cross-project memory`);
     console.log(`  ${C.primary('cell dashboard')}     Open web dashboard in browser`);
+    console.log(`  ${C.primary('cell perf')}         Show performance stats & cache info`);
+    console.log(`  ${C.primary('cell migrate')}      Run database migrations`);
     console.log(`  ${C.primary('cell context --topic')} Add topic-based memory search to context`);
     console.log(`  ${C.primary('cell repl')}        Interactive REPL with / completion (or just run \`cell\` in a TTY)`);
     console.log(`  ${C.primary('cell help')}        Show this help`);
@@ -3387,6 +3396,57 @@ function doHandoff() {
     console.log(C.dim('  cell handoff --log "title" "summary"  Log new entry'));
     console.log();
 }
+// ─── cell migrate — run database migrations ───────────────────────────────
+function doMigrate() {
+    console.log(C.bold('  ── Database Migrations ──\n'));
+    try {
+        const { getMigrationStatus, runMigrations } = require('../../06-memory/database/migrations');
+        const status = getMigrationStatus();
+        console.log(C.dim(`  Current version: ${status.currentVersion}`));
+        console.log(C.dim(`  Applied: ${status.applied.join(', ') || 'none'}`));
+        console.log(C.dim(`  Pending: ${status.pending}\n`));
+        if (status.pending > 0) {
+            const result = runMigrations();
+            if (result.errors.length > 0) {
+                console.log(C.warn(`  Applied ${result.applied}, ${result.errors.length} errors:`));
+                for (const e of result.errors)
+                    console.log(C.warn(`    ${e}`));
+            }
+            else {
+                console.log(C.success(`  Applied ${result.applied} migration(s)`));
+            }
+        }
+        else {
+            console.log(C.dim('  Database is up to date.'));
+        }
+    }
+    catch (e) {
+        console.log(C.warn(`  Migration failed: ${e?.message || String(e)}`));
+    }
+    console.log();
+}
+// ─── cell perf — performance stats & cache info ───────────────────────────
+function doPerf() {
+    console.log(C.bold('  ── Performance ──\n'));
+    try {
+        const { getCacheStats } = require('../../06-memory/database/query-cache');
+        const { getDatabaseStats, optimizeDatabase } = require('../../06-memory/database/database');
+        const stats = getCacheStats();
+        console.log(`  Query Cache:`);
+        console.log(`    Size:     ${C.num(String(stats.size))} entries`);
+        console.log(`    Hits:     ${C.num(String(stats.hits))}`);
+        console.log(`    Misses:   ${C.num(String(stats.misses))}`);
+        console.log(`    Hit rate: ${stats.hitRate}`);
+        const dbStats = getDatabaseStats();
+        console.log(`\n  Database:`);
+        console.log(`    Tables:   ${C.num(String(Object.keys(dbStats).length - 2))}`);
+        console.log(`    Size:     ${(dbStats.db_size_bytes / 1024).toFixed(1)} KB`);
+    }
+    catch (e) {
+        console.log(C.warn(`  Perf check failed: ${e?.message || String(e)}`));
+    }
+    console.log();
+}
 // ─── cell dashboard — open web dashboard ───────────────────────────────────
 function doDashboard() {
     console.log(C.bold('  ── Cell Dashboard ──\n'));