@miller-tech/uap 1.0.0

package/dist/memory/predictive-memory.js

@@ -0,0 +1,294 @@
+/**
+ * Predictive Memory Service for UAP
+ *
+ * Predicts which memory queries will be needed for a given task and
+ * prefetches them to reduce latency. Learns from observed access
+ * patterns to improve predictions over time.
+ */
+import { jaccardSimilarity } from '../utils/string-similarity.js';
+/**
+ * Category-to-keywords mapping for domain-based prediction.
+ * Security tasks need auth patterns, deployment tasks need infra patterns, etc.
+ */
+const CATEGORY_QUERIES = {
+    security: ['authentication', 'authorization', 'auth patterns', 'security policy', 'credentials'],
+    deployment: ['deploy process', 'infrastructure', 'CI/CD', 'environment config', 'release'],
+    testing: ['test patterns', 'test fixtures', 'test coverage', 'mocking', 'assertions'],
+    refactor: ['code patterns', 'architecture decisions', 'tech debt', 'design patterns'],
+    database: ['schema', 'migrations', 'query patterns', 'database config', 'ORM'],
+    api: ['endpoints', 'API design', 'request handling', 'response format', 'middleware'],
+    performance: ['optimization', 'caching', 'profiling', 'bottleneck', 'benchmarks'],
+    debugging: ['error patterns', 'logging', 'stack traces', 'common bugs', 'troubleshooting'],
+};
+/**
+ * PredictiveMemoryService predicts what memory queries will be needed
+ * for a task, prefetches them, and learns from actual access patterns.
+ */
+export class PredictiveMemoryService {
+    /**
+     * Learned mapping: task-type keywords -> queries that were actually used.
+     * Map<normalized-task-keyword, string[]>
+     */
+    learnedQueries = new Map();
+    /**
+     * Recent task history for similarity matching.
+     * Array of { taskDescription, queriesUsed }
+     */
+    taskHistory = [];
+    maxHistory = 100;
+    /**
+     * Predict what memory queries will be needed for a task.
+     *
+     * Uses three strategies:
+     * 1. Task similarity: if a similar task was done before, reuse its queries
+     * 2. Entity extraction: extract technical entities from the task description
+     * 3. Category-based: match task to known categories and return relevant queries
+     *
+     * @param taskDescription - Description of the upcoming task
+     * @param recentTasks - Recent task descriptions for context
+     * @returns Array of predicted query strings
+     */
+    predictNeededContext(taskDescription, recentTasks) {
+        const predictions = new Set();
+        // Strategy 1: Task similarity - find similar past tasks and reuse their queries
+        this.predictFromSimilarTasks(taskDescription, predictions);
+        // Strategy 2: Entity extraction - extract named entities from description
+        this.predictFromEntities(taskDescription, predictions);
+        // Strategy 3: Category-based - match task to known categories
+        this.predictFromCategories(taskDescription, predictions);
+        // Strategy 4: Recent task context - extract entities from recent tasks
+        for (const recent of recentTasks.slice(0, 3)) {
+            this.predictFromEntities(recent, predictions);
+        }
+        // Strategy 5: Learned patterns from recordAccess
+        this.predictFromLearned(taskDescription, predictions);
+        return [...predictions];
+    }
+    /**
+     * Prefetch predicted memories using the provided memory service.
+     *
+     * @param predictions - Array of query strings to prefetch
+     * @param memoryService - Service with a query method
+     * @returns Map of query -> results
+     */
+    async prefetch(predictions, memoryService) {
+        const results = new Map();
+        // Run all queries in parallel
+        const entries = await Promise.all(predictions.map(async (query) => {
+            try {
+                const queryResults = await memoryService.query(query);
+                return [query, queryResults];
+            }
+            catch {
+                return [query, []];
+            }
+        }));
+        for (const [query, queryResults] of entries) {
+            results.set(query, [...queryResults]);
+        }
+        return results;
+    }
+    /**
+     * Record which queries were actually used for a task.
+     * This feeds the learning model so future predictions improve.
+     *
+     * @param taskDescription - The task that was performed
+     * @param queriesUsed - The queries that were actually accessed
+     */
+    recordAccess(taskDescription, queriesUsed) {
+        // Store in history
+        this.taskHistory.push({ description: taskDescription, queries: queriesUsed });
+        if (this.taskHistory.length > this.maxHistory) {
+            this.taskHistory.shift();
+        }
+        // Extract keywords and map to queries
+        const keywords = this.extractKeywords(taskDescription);
+        for (const keyword of keywords) {
+            const existing = this.learnedQueries.get(keyword) || [];
+            const merged = [...new Set([...existing, ...queriesUsed])];
+            this.learnedQueries.set(keyword, merged);
+        }
+    }
+    /**
+     * Find similar past tasks and add their queries as predictions.
+     */
+    predictFromSimilarTasks(taskDescription, predictions) {
+        for (const past of this.taskHistory) {
+            const similarity = jaccardSimilarity(taskDescription.toLowerCase(), past.description.toLowerCase());
+            if (similarity > 0.3) {
+                for (const query of past.queries) {
+                    predictions.add(query);
+                }
+            }
+        }
+    }
+    /**
+     * Extract technical entities from a description and use them as queries.
+     */
+    predictFromEntities(description, predictions) {
+        // File paths
+        const paths = description.match(/[\w./\\-]+\.(ts|js|py|json|yaml|yml|md|sh|sql)/gi);
+        if (paths) {
+            for (const p of paths) {
+                predictions.add(p);
+            }
+        }
+        // Function/class names (camelCase or PascalCase)
+        const names = description.match(/\b[a-z][a-zA-Z0-9]*(?:[A-Z][a-zA-Z0-9]*)+\b/g);
+        if (names) {
+            for (const n of names) {
+                predictions.add(n);
+            }
+        }
+        // Quoted strings
+        const quoted = description.match(/`([^`]+)`/g);
+        if (quoted) {
+            for (const q of quoted) {
+                predictions.add(q.replace(/`/g, ''));
+            }
+        }
+        // Technical terms (2+ word phrases with common dev terms)
+        const techTerms = description.match(/\b(?:api|database|auth|config|deploy|test|build|schema|migration|route|middleware|handler|service|module|component|hook|plugin|pattern)\s+\w+/gi);
+        if (techTerms) {
+            for (const term of techTerms) {
+                predictions.add(term.trim());
+            }
+        }
+    }
+    /**
+     * Match task description to known categories and add category queries.
+     */
+    predictFromCategories(description, predictions) {
+        const lower = description.toLowerCase();
+        for (const [category, queries] of Object.entries(CATEGORY_QUERIES)) {
+            // Check if the category keyword appears in the description
+            if (lower.includes(category)) {
+                for (const query of queries) {
+                    predictions.add(query);
+                }
+                continue;
+            }
+            // Also check if any of the category's queries appear as keywords
+            const matchCount = queries.filter((q) => lower.includes(q.toLowerCase())).length;
+            if (matchCount >= 2) {
+                for (const query of queries) {
+                    predictions.add(query);
+                }
+            }
+        }
+    }
+    /**
+     * Use learned keyword->query mappings for prediction.
+     */
+    predictFromLearned(description, predictions) {
+        const keywords = this.extractKeywords(description);
+        for (const keyword of keywords) {
+            const queries = this.learnedQueries.get(keyword);
+            if (queries) {
+                for (const query of queries) {
+                    predictions.add(query);
+                }
+            }
+        }
+    }
+    /**
+     * Extract significant keywords from a task description.
+     * Filters out common stop words and very short words.
+     */
+    extractKeywords(description) {
+        const stopWords = new Set([
+            'the',
+            'a',
+            'an',
+            'is',
+            'are',
+            'was',
+            'were',
+            'be',
+            'been',
+            'being',
+            'have',
+            'has',
+            'had',
+            'do',
+            'does',
+            'did',
+            'will',
+            'would',
+            'could',
+            'should',
+            'may',
+            'might',
+            'can',
+            'shall',
+            'to',
+            'of',
+            'in',
+            'for',
+            'on',
+            'with',
+            'at',
+            'by',
+            'from',
+            'as',
+            'into',
+            'through',
+            'during',
+            'before',
+            'after',
+            'above',
+            'below',
+            'between',
+            'and',
+            'but',
+            'or',
+            'not',
+            'no',
+            'nor',
+            'so',
+            'yet',
+            'both',
+            'each',
+            'few',
+            'more',
+            'most',
+            'other',
+            'some',
+            'such',
+            'than',
+            'too',
+            'very',
+            'just',
+            'about',
+            'up',
+            'out',
+            'if',
+            'then',
+            'that',
+            'this',
+            'it',
+            'its',
+            'all',
+            'any',
+            'new',
+            'also',
+            'get',
+            'set',
+            'use',
+        ]);
+        return description
+            .toLowerCase()
+            .split(/\s+/)
+            .map((w) => w.replace(/[^a-z0-9-_]/g, ''))
+            .filter((w) => w.length > 2 && !stopWords.has(w));
+    }
+}
+// Singleton
+let instance = null;
+export function getPredictiveMemoryService() {
+    if (!instance) {
+        instance = new PredictiveMemoryService();
+    }
+    return instance;
+}
+//# sourceMappingURL=predictive-memory.js.map

package/dist/memory/predictive-memory.js.map

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

package/dist/memory/prepopulate.d.ts

@@ -0,0 +1,76 @@
+import type { MemoryEntry } from './backends/base.js';
+export interface PrepopulateOptions {
+    docs?: boolean;
+    git?: boolean;
+    skills?: boolean;
+    limit?: number;
+    since?: string;
+    verbose?: boolean;
+}
+export interface PrepopulateResult {
+    docsProcessed: number;
+    gitCommitsProcessed: number;
+    skillsDiscovered: number;
+    artifactsDiscovered: number;
+    memoriesCreated: number;
+    errors: string[];
+}
+export interface DiscoveredSkill {
+    name: string;
+    path: string;
+    type: 'droid' | 'skill' | 'command' | 'artifact';
+    description?: string;
+    platform: 'factory' | 'claude' | 'opencode' | 'generic';
+}
+interface ParsedDocument {
+    path: string;
+    title: string;
+    sections: Array<{
+        heading: string;
+        content: string;
+        type: 'setup' | 'architecture' | 'api' | 'troubleshooting' | 'general';
+    }>;
+}
+interface GitCommit {
+    hash: string;
+    date: string;
+    author: string;
+    message: string;
+    body: string;
+    files: string[];
+    type: 'fix' | 'feat' | 'refactor' | 'docs' | 'test' | 'chore' | 'revert' | 'other';
+}
+/**
+ * Prepopulate memory from project documentation, git history, and skills/artifacts
+ */
+export declare function prepopulateMemory(cwd: string, options?: PrepopulateOptions): Promise<{
+    shortTerm: MemoryEntry[];
+    longTerm: MemoryEntry[];
+    skills: DiscoveredSkill[];
+}>;
+/**
+ * Parse all documentation files in the project
+ */
+export declare function parseDocumentation(cwd: string, verbose?: boolean): Promise<ParsedDocument[]>;
+/**
+ * Extract git commit history with details
+ */
+export declare function extractGitHistory(cwd: string, limit?: number, since?: string): Promise<GitCommit[]>;
+/**
+ * Convert documentation into memory entries
+ */
+export declare function extractDocumentationMemories(docs: ParsedDocument[]): MemoryEntry[];
+/**
+ * Convert git history into memory entries with learnings
+ */
+export declare function extractGitLearnings(commits: GitCommit[]): MemoryEntry[];
+/**
+ * Discover skills, droids, commands, and artifacts from various platforms
+ */
+export declare function discoverSkillsAndArtifacts(cwd: string, verbose?: boolean): Promise<DiscoveredSkill[]>;
+/**
+ * Convert discovered skills into memory entries
+ */
+export declare function extractSkillMemories(skills: DiscoveredSkill[]): MemoryEntry[];
+export {};
+//# sourceMappingURL=prepopulate.d.ts.map

package/dist/memory/prepopulate.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"prepopulate.d.ts","sourceRoot":"","sources":["../../src/memory/prepopulate.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAC;AAEtD,MAAM,WAAW,kBAAkB;IACjC,IAAI,CAAC,EAAE,OAAO,CAAC;IACf,GAAG,CAAC,EAAE,OAAO,CAAC;IACd,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,OAAO,CAAC,EAAE,OAAO,CAAC;CACnB;AAED,MAAM,WAAW,iBAAiB;IAChC,aAAa,EAAE,MAAM,CAAC;IACtB,mBAAmB,EAAE,MAAM,CAAC;IAC5B,gBAAgB,EAAE,MAAM,CAAC;IACzB,mBAAmB,EAAE,MAAM,CAAC;IAC5B,eAAe,EAAE,MAAM,CAAC;IACxB,MAAM,EAAE,MAAM,EAAE,CAAC;CAClB;AAED,MAAM,WAAW,eAAe;IAC9B,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,OAAO,GAAG,OAAO,GAAG,SAAS,GAAG,UAAU,CAAC;IACjD,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,QAAQ,EAAE,SAAS,GAAG,QAAQ,GAAG,UAAU,GAAG,SAAS,CAAC;CACzD;AAED,UAAU,cAAc;IACtB,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,MAAM,CAAC;IACd,QAAQ,EAAE,KAAK,CAAC;QACd,OAAO,EAAE,MAAM,CAAC;QAChB,OAAO,EAAE,MAAM,CAAC;QAChB,IAAI,EAAE,OAAO,GAAG,cAAc,GAAG,KAAK,GAAG,iBAAiB,GAAG,SAAS,CAAC;KACxE,CAAC,CAAC;CACJ;AAED,UAAU,SAAS;IACjB,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,MAAM,CAAC;IACf,OAAO,EAAE,MAAM,CAAC;IAChB,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,MAAM,EAAE,CAAC;IAChB,IAAI,EAAE,KAAK,GAAG,MAAM,GAAG,UAAU,GAAG,MAAM,GAAG,MAAM,GAAG,OAAO,GAAG,QAAQ,GAAG,OAAO,CAAC;CACpF;AAED;;GAEG;AACH,wBAAsB,iBAAiB,CACrC,GAAG,EAAE,MAAM,EACX,OAAO,GAAE,kBAAuB,GAC/B,OAAO,CAAC;IAAE,SAAS,EAAE,WAAW,EAAE,CAAC;IAAC,QAAQ,EAAE,WAAW,EAAE,CAAC;IAAC,MAAM,EAAE,eAAe,EAAE,CAAA;CAAE,CAAC,CAmD3F;AAED;;GAEG;AACH,wBAAsB,kBAAkB,CAAC,GAAG,EAAE,MAAM,EAAE,OAAO,UAAQ,GAAG,OAAO,CAAC,cAAc,EAAE,CAAC,CA2DhG;AAED;;GAEG;AACH,wBAAsB,iBAAiB,CACrC,GAAG,EAAE,MAAM,EACX,KAAK,SAAM,EACX,KAAK,CAAC,EAAE,MAAM,GACb,OAAO,CAAC,SAAS,EAAE,CAAC,CA+EtB;AAED;;GAEG;AACH,wBAAgB,4BAA4B,CAAC,IAAI,EAAE,cAAc,EAAE,GAAG,WAAW,EAAE,CAmClF;AAED;;GAEG;AACH,wBAAgB,mBAAmB,CAAC,OAAO,EAAE,SAAS,EAAE,GAAG,WAAW,EAAE,CAgHvE;AAgUD;;GAEG;AACH,wBAAsB,0BAA0B,CAC9C,GAAG,EAAE,MAAM,EACX,OAAO,UAAQ,GACd,OAAO,CAAC,eAAe,EAAE,CAAC,CAsG5B;AA8CD;;GAEG;AACH,wBAAgB,oBAAoB,CAAC,MAAM,EAAE,eAAe,EAAE,GAAG,WAAW,EAAE,CAmG7E"}