@traqr/memory 0.1.0

package/dist/lib/learning-extractor.d.ts

@@ -0,0 +1,144 @@
+/**
+ * Learning Extractor — Portable
+ *
+ * Auto-extract learnings from PRs, sessions, codebases, and voice samples.
+ * Uses OpenAI for extraction, stores in @traqr/memory.
+ *
+ * Portable version: no NookTraqr-specific imports. Uses package-internal
+ * memory operations and env-based project identity.
+ */
+import type { MemoryCategory } from '../vectordb/types.js';
+import type { MemorySearchResult } from '../vectordb/types.js';
+/**
+ * Resolve the current project slug for memory tagging.
+ * Checks env var first (set by daemon/templates), falls back to 'default'.
+ */
+export declare function getSourceProject(): string;
+export interface PRContext {
+    prNumber: number;
+    title: string;
+    filesChanged: string[];
+    diffSummary?: string;
+    templatePath?: string;
+    description?: string;
+}
+export type SuggestedLayer = 'vector_db' | 'claude_memory' | 'claude_md';
+export interface ExtractedLearning {
+    content: string;
+    category: MemoryCategory;
+    tags: string[];
+    confidence: number;
+    suggestedLayer?: SuggestedLayer;
+}
+export interface ExtractionResult {
+    memoriesStored: number;
+    memoriesDeduplicated: number;
+    learnings: ExtractedLearning[];
+    errors: string[];
+    layerSuggestions: Array<{
+        content: string;
+        layer: SuggestedLayer;
+        reason: string;
+    }>;
+}
+export declare function extractLearningsFromPR(context: PRContext): Promise<ExtractionResult>;
+export declare function batchExtractLearnings(prs: PRContext[], options?: {
+    delayMs?: number;
+    onProgress?: (completed: number, total: number) => void;
+}): Promise<{
+    totalMemories: number;
+    prResults: Map<number, ExtractionResult>;
+}>;
+export declare function submitManualLearning(content: string, category: MemoryCategory, tags: string[], context?: {
+    topic?: string;
+    templatePath?: string;
+    sessionId?: string;
+}): Promise<{
+    success: boolean;
+    memoryId?: string;
+    error?: string;
+}>;
+export declare function extractFromConversation(conversationContent: string, context?: {
+    topic?: string;
+    templatePath?: string;
+}): Promise<ExtractedLearning[]>;
+export interface SessionDiffContext {
+    slot: string;
+    branch: string;
+    task?: string;
+    diffSummary: string;
+    diffContent?: string;
+    filesChanged: string[];
+    commitMessages: string[];
+}
+export interface SessionExtractionResult {
+    memoriesStored: number;
+    memoriesDeduplicated: number;
+    learnings: ExtractedLearning[];
+    errors: string[];
+    contradictions?: Array<{
+        newLearning: string;
+        conflictsWith: string;
+        conflictId?: string;
+    }>;
+    layerSuggestions: Array<{
+        content: string;
+        layer: SuggestedLayer;
+        reason: string;
+    }>;
+}
+export declare function extractFromSessionDiff(context: SessionDiffContext): Promise<SessionExtractionResult>;
+export interface PlanContext {
+    planId: string;
+    title: string;
+    planContent: string;
+    outcome: 'success' | 'partial' | 'failed';
+    prNumber?: number;
+    filesPlanned: string[];
+    filesActual: string[];
+    buildPassed: boolean;
+}
+export declare function extractLearningsFromPlan(context: PlanContext): Promise<SessionExtractionResult>;
+export interface CodebaseAnalysisContext {
+    analysisType: 'component-patterns' | 'design-system' | 'state-management' | 'error-handling' | 'api-patterns' | 'naming-conventions' | 'typescript-patterns' | 'animation-patterns' | 'layout-patterns' | 'performance-patterns' | 'full';
+    fileSamples: {
+        path: string;
+        content: string;
+    }[];
+    configFiles?: {
+        path: string;
+        content: string;
+    }[];
+}
+export interface CodebaseAnalysisResult {
+    memoriesStored: number;
+    memoriesDeduplicated: number;
+    learnings: ExtractedLearning[];
+    errors: string[];
+    analysisType: string;
+}
+export declare function extractFromCodebaseAnalysis(context: CodebaseAnalysisContext): Promise<CodebaseAnalysisResult>;
+export interface ContradictionResult {
+    isContradiction: boolean;
+    conflictsWith?: string;
+    conflictId?: string;
+    similarity?: number;
+}
+export declare function detectContradictions(newLearning: string, existingMemories?: MemorySearchResult[]): Promise<ContradictionResult>;
+export type VoiceAnalysisType = 'user-facing' | 'business' | 'technical' | 'social' | 'brand' | 'full';
+export interface VoiceAnalysisContext {
+    analysisType: VoiceAnalysisType;
+    writingSamples: {
+        label: string;
+        content: string;
+    }[];
+}
+export interface VoiceAnalysisResult {
+    memoriesStored: number;
+    memoriesDeduplicated: number;
+    learnings: ExtractedLearning[];
+    errors: string[];
+    analysisType: string;
+}
+export declare function extractVoiceTraits(context: VoiceAnalysisContext): Promise<VoiceAnalysisResult>;
+export declare function formatExtractionResult(result: ExtractionResult): string;

package/dist/lib/learning-extractor.d.ts.map

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