@teamlens/core 0.1.0

package/dist/types.d.ts

@@ -0,0 +1,223 @@
+export type MemoryCategory = 'architecture' | 'convention' | 'decision' | 'correction' | 'active_context' | 'discovery' | 'gotcha' | 'dependency';
+export type MemorySource = 'git' | 'agent' | 'manual' | 'rule' | 'session';
+export type MemoryTier = 'personal' | 'team';
+export type RulePriority = 'critical' | 'high' | 'normal' | 'low';
+export type DistributionTarget = 'claude' | 'cursor' | 'copilot' | 'agents_md';
+export type InsightType = 'gotcha' | 'convention' | 'architecture' | 'dependency' | 'decision' | 'correction' | 'discovery';
+export type SessionStatus = 'active' | 'completed' | 'abandoned';
+export type ActivityType = 'debug' | 'refactor' | 'file_edit' | 'review' | 'test' | 'research' | 'implementation' | 'other';
+export interface Memory {
+    id: string;
+    content: string;
+    category: MemoryCategory;
+    source: MemorySource;
+    /** personal = local only, team = synced via team.jsonl */
+    tier: MemoryTier;
+    /** Who created this memory (git username or "agent") */
+    author: string;
+    tags: string[];
+    /** File paths this memory is about */
+    relatedFiles: string[];
+    /** Commit SHA that produced this memory (if git-sourced) */
+    commitSha: string | null;
+    /** 0.0 = fresh, 1.0 = fully stale */
+    staleness: number;
+    /** How confident we are in this memory (0.0–1.0) */
+    confidence: number;
+    /** Embedding vector (null until computed) */
+    embedding: number[] | null;
+    /** Glob patterns this rule applies to (null = global rule) */
+    scope: string[] | null;
+    /** Ordering priority in generated configs (null = 'normal') */
+    priority: RulePriority | null;
+    /** Code examples for this rule */
+    examples: {
+        good?: string;
+        bad?: string;
+    } | null;
+    /** Whether this rule is active (inactive rules are hidden but not deleted) */
+    active: boolean;
+    /** Session ID that produced this memory (null if not from a session) */
+    sessionId: string | null;
+    /** Number of times this insight was reused by other sessions */
+    reuseCount: number;
+    createdAt: string;
+    updatedAt: string;
+    validatedAt: string;
+}
+/** A single line in team.jsonl — the git-synced team memory format. */
+export interface SharedMemoryEntry {
+    id: string;
+    content: string;
+    category: MemoryCategory;
+    source: MemorySource;
+    author: string;
+    tags: string[];
+    relatedFiles: string[];
+    commitSha: string | null;
+    confidence: number;
+    scope?: string[] | null;
+    priority?: RulePriority | null;
+    examples?: {
+        good?: string;
+        bad?: string;
+    } | null;
+    active?: boolean;
+    createdAt: string;
+}
+export interface TrackedFile {
+    path: string;
+    /** Last known git hash of this file */
+    hash: string;
+    lastModified: string;
+}
+export interface TrackedCommit {
+    sha: string;
+    message: string;
+    author: string;
+    date: string;
+    /** Files touched in this commit */
+    files: string[];
+    /** Whether we already extracted memories from this commit */
+    processed: boolean;
+}
+export interface Session {
+    id: string;
+    developer: string;
+    task: string;
+    status: SessionStatus;
+    toolName: string;
+    startedAt: string;
+    endedAt: string | null;
+    durationSeconds: number | null;
+    filesTouched: string[];
+    summary: string | null;
+    insightCount: number;
+    activityCount: number;
+    duplicatesPrevented: number;
+}
+export interface ActivityEvent {
+    id: string;
+    sessionId: string;
+    type: ActivityType;
+    description: string;
+    files: string[];
+    timestamp: string;
+}
+export interface DeveloperStats {
+    developer: string;
+    totalSessions: number;
+    totalInsights: number;
+    avgSessionDuration: number;
+    insightsPerSession: number;
+    knowledgeReused: number;
+    lastActive: string | null;
+}
+export interface ContributorEntry {
+    rank: number;
+    developer: string;
+    insightsShared: number;
+    knowledgeReused: number;
+    impactScore: number;
+}
+export interface ROIMetrics {
+    duplicatesPrevented: number;
+    knowledgeReuseCount: number;
+    estimatedHoursSaved: number;
+    insightsPerAIHour: number;
+    teamKnowledgeCoverage: number;
+}
+export interface UsageTrend {
+    date: string;
+    sessions: number;
+    insights: number;
+    activeDevelopers: number;
+}
+export interface HotFile {
+    filePath: string;
+    insightCount: number;
+    lastInsight: string;
+}
+export interface TeamAnalytics {
+    overview: {
+        totalSessions: number;
+        totalInsights: number;
+        activeDevelopers: number;
+        avgInsightsPerSession: number;
+    };
+    roi: ROIMetrics;
+    trends: UsageTrend[];
+    contributors: ContributorEntry[];
+    hotFiles: HotFile[];
+    insightsByType: Record<string, number>;
+}
+export interface RetrievalQuery {
+    query: string;
+    /** Narrow results to memories about files in this directory */
+    scope?: string;
+    /** Filter by category */
+    category?: MemoryCategory;
+    /** Filter by tier */
+    tier?: MemoryTier;
+    /** Max results to return */
+    limit?: number;
+    /** Include stale memories (default: false) */
+    includeStale?: boolean;
+}
+export interface ScoredMemory {
+    memory: Memory;
+    score: number;
+    /** Breakdown of how the score was computed */
+    breakdown: {
+        semantic: number;
+        fileProximity: number;
+        recency: number;
+        confidence: number;
+        stalenessPenalty: number;
+    };
+}
+export interface StalenessCheck {
+    memoryId: string;
+    reason: 'file_deleted' | 'file_renamed' | 'minor_edit' | 'major_refactor' | 'function_removed';
+    oldStaleness: number;
+    newStaleness: number;
+    changedFile: string;
+}
+export interface ExtractedMemory {
+    content: string;
+    category: MemoryCategory;
+    relatedFiles: string[];
+    tags: string[];
+    confidence: number;
+    commitSha: string | null;
+}
+export interface TeamLensConfig {
+    /** Directory to store memory data (default: .teamlens) */
+    storageDir: string;
+    /** Enable local embeddings via Ollama (default: true) */
+    localEmbeddings: boolean;
+    /** Ollama model for embeddings (default: nomic-embed-text) */
+    embeddingModel: string;
+    /** Ollama host (default: http://localhost:11434) */
+    ollamaHost: string;
+    /** Staleness threshold to auto-flag (default: 0.6) */
+    stalenessThreshold: number;
+    /** Max memories to return per query (default: 10) */
+    defaultLimit: number;
+    /** File patterns to ignore (default: node_modules, dist, etc.) */
+    ignorePatterns: string[];
+    /** Author name for memories (default: git user.name or "unknown") */
+    author: string;
+    /** Enable session tracking (default: true) */
+    sessionTracking: boolean;
+    /** Auto-close sessions after N minutes of inactivity (default: 60) */
+    sessionTimeoutMinutes: number;
+    /** Developer name for sessions (defaults to author) */
+    developer: string;
+    /** Port for the web dashboard (default: 3847) */
+    webPort: number;
+}
+/** @deprecated Use TeamLensConfig instead */
+export type CodeMemoryConfig = TeamLensConfig;
+export declare const DEFAULT_CONFIG: TeamLensConfig;
+//# sourceMappingURL=types.d.ts.map

package/dist/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAEA,MAAM,MAAM,cAAc,GACtB,cAAc,GACd,YAAY,GACZ,UAAU,GACV,YAAY,GACZ,gBAAgB,GAChB,WAAW,GACX,QAAQ,GACR,YAAY,CAAC;AAEjB,MAAM,MAAM,YAAY,GAAG,KAAK,GAAG,OAAO,GAAG,QAAQ,GAAG,MAAM,GAAG,SAAS,CAAC;AAE3E,MAAM,MAAM,UAAU,GAAG,UAAU,GAAG,MAAM,CAAC;AAE7C,MAAM,MAAM,YAAY,GAAG,UAAU,GAAG,MAAM,GAAG,QAAQ,GAAG,KAAK,CAAC;AAElE,MAAM,MAAM,kBAAkB,GAAG,QAAQ,GAAG,QAAQ,GAAG,SAAS,GAAG,WAAW,CAAC;AAE/E,MAAM,MAAM,WAAW,GACnB,QAAQ,GACR,YAAY,GACZ,cAAc,GACd,YAAY,GACZ,UAAU,GACV,YAAY,GACZ,WAAW,CAAC;AAEhB,MAAM,MAAM,aAAa,GAAG,QAAQ,GAAG,WAAW,GAAG,WAAW,CAAC;AAEjE,MAAM,MAAM,YAAY,GACpB,OAAO,GACP,UAAU,GACV,WAAW,GACX,QAAQ,GACR,MAAM,GACN,UAAU,GACV,gBAAgB,GAChB,OAAO,CAAC;AAIZ,MAAM,WAAW,MAAM;IACrB,EAAE,EAAE,MAAM,CAAC;IACX,OAAO,EAAE,MAAM,CAAC;IAChB,QAAQ,EAAE,cAAc,CAAC;IACzB,MAAM,EAAE,YAAY,CAAC;IACrB,0DAA0D;IAC1D,IAAI,EAAE,UAAU,CAAC;IACjB,wDAAwD;IACxD,MAAM,EAAE,MAAM,CAAC;IACf,IAAI,EAAE,MAAM,EAAE,CAAC;IACf,sCAAsC;IACtC,YAAY,EAAE,MAAM,EAAE,CAAC;IACvB,4DAA4D;IAC5D,SAAS,EAAE,MAAM,GAAG,IAAI,CAAC;IACzB,qCAAqC;IACrC,SAAS,EAAE,MAAM,CAAC;IAClB,oDAAoD;IACpD,UAAU,EAAE,MAAM,CAAC;IACnB,6CAA6C;IAC7C,SAAS,EAAE,MAAM,EAAE,GAAG,IAAI,CAAC;IAC3B,8DAA8D;IAC9D,KAAK,EAAE,MAAM,EAAE,GAAG,IAAI,CAAC;IACvB,+DAA+D;IAC/D,QAAQ,EAAE,YAAY,GAAG,IAAI,CAAC;IAC9B,kCAAkC;IAClC,QAAQ,EAAE;QAAE,IAAI,CAAC,EAAE,MAAM,CAAC;QAAC,GAAG,CAAC,EAAE,MAAM,CAAA;KAAE,GAAG,IAAI,CAAC;IACjD,8EAA8E;IAC9E,MAAM,EAAE,OAAO,CAAC;IAChB,wEAAwE;IACxE,SAAS,EAAE,MAAM,GAAG,IAAI,CAAC;IACzB,gEAAgE;IAChE,UAAU,EAAE,MAAM,CAAC;IACnB,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,EAAE,MAAM,CAAC;IAClB,WAAW,EAAE,MAAM,CAAC;CACrB;AAED,uEAAuE;AACvE,MAAM,WAAW,iBAAiB;IAChC,EAAE,EAAE,MAAM,CAAC;IACX,OAAO,EAAE,MAAM,CAAC;IAChB,QAAQ,EAAE,cAAc,CAAC;IACzB,MAAM,EAAE,YAAY,CAAC;IACrB,MAAM,EAAE,MAAM,CAAC;IACf,IAAI,EAAE,MAAM,EAAE,CAAC;IACf,YAAY,EAAE,MAAM,EAAE,CAAC;IACvB,SAAS,EAAE,MAAM,GAAG,IAAI,CAAC;IACzB,UAAU,EAAE,MAAM,CAAC;IACnB,KAAK,CAAC,EAAE,MAAM,EAAE,GAAG,IAAI,CAAC;IACxB,QAAQ,CAAC,EAAE,YAAY,GAAG,IAAI,CAAC;IAC/B,QAAQ,CAAC,EAAE;QAAE,IAAI,CAAC,EAAE,MAAM,CAAC;QAAC,GAAG,CAAC,EAAE,MAAM,CAAA;KAAE,GAAG,IAAI,CAAC;IAClD,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,SAAS,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,WAAW,WAAW;IAC1B,IAAI,EAAE,MAAM,CAAC;IACb,uCAAuC;IACvC,IAAI,EAAE,MAAM,CAAC;IACb,YAAY,EAAE,MAAM,CAAC;CACtB;AAED,MAAM,WAAW,aAAa;IAC5B,GAAG,EAAE,MAAM,CAAC;IACZ,OAAO,EAAE,MAAM,CAAC;IAChB,MAAM,EAAE,MAAM,CAAC;IACf,IAAI,EAAE,MAAM,CAAC;IACb,mCAAmC;IACnC,KAAK,EAAE,MAAM,EAAE,CAAC;IAChB,6DAA6D;IAC7D,SAAS,EAAE,OAAO,CAAC;CACpB;AAID,MAAM,WAAW,OAAO;IACtB,EAAE,EAAE,MAAM,CAAC;IACX,SAAS,EAAE,MAAM,CAAC;IAClB,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,aAAa,CAAC;IACtB,QAAQ,EAAE,MAAM,CAAC;IACjB,SAAS,EAAE,MAAM,CAAC;IAClB,OAAO,EAAE,MAAM,GAAG,IAAI,CAAC;IACvB,eAAe,EAAE,MAAM,GAAG,IAAI,CAAC;IAC/B,YAAY,EAAE,MAAM,EAAE,CAAC;IACvB,OAAO,EAAE,MAAM,GAAG,IAAI,CAAC;IACvB,YAAY,EAAE,MAAM,CAAC;IACrB,aAAa,EAAE,MAAM,CAAC;IACtB,mBAAmB,EAAE,MAAM,CAAC;CAC7B;AAED,MAAM,WAAW,aAAa;IAC5B,EAAE,EAAE,MAAM,CAAC;IACX,SAAS,EAAE,MAAM,CAAC;IAClB,IAAI,EAAE,YAAY,CAAC;IACnB,WAAW,EAAE,MAAM,CAAC;IACpB,KAAK,EAAE,MAAM,EAAE,CAAC;IAChB,SAAS,EAAE,MAAM,CAAC;CACnB;AAID,MAAM,WAAW,cAAc;IAC7B,SAAS,EAAE,MAAM,CAAC;IAClB,aAAa,EAAE,MAAM,CAAC;IACtB,aAAa,EAAE,MAAM,CAAC;IACtB,kBAAkB,EAAE,MAAM,CAAC;IAC3B,kBAAkB,EAAE,MAAM,CAAC;IAC3B,eAAe,EAAE,MAAM,CAAC;IACxB,UAAU,EAAE,MAAM,GAAG,IAAI,CAAC;CAC3B;AAED,MAAM,WAAW,gBAAgB;IAC/B,IAAI,EAAE,MAAM,CAAC;IACb,SAAS,EAAE,MAAM,CAAC;IAClB,cAAc,EAAE,MAAM,CAAC;IACvB,eAAe,EAAE,MAAM,CAAC;IACxB,WAAW,EAAE,MAAM,CAAC;CACrB;AAED,MAAM,WAAW,UAAU;IACzB,mBAAmB,EAAE,MAAM,CAAC;IAC5B,mBAAmB,EAAE,MAAM,CAAC;IAC5B,mBAAmB,EAAE,MAAM,CAAC;IAC5B,iBAAiB,EAAE,MAAM,CAAC;IAC1B,qBAAqB,EAAE,MAAM,CAAC;CAC/B;AAED,MAAM,WAAW,UAAU;IACzB,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,EAAE,MAAM,CAAC;IACjB,QAAQ,EAAE,MAAM,CAAC;IACjB,gBAAgB,EAAE,MAAM,CAAC;CAC1B;AAED,MAAM,WAAW,OAAO;IACtB,QAAQ,EAAE,MAAM,CAAC;IACjB,YAAY,EAAE,MAAM,CAAC;IACrB,WAAW,EAAE,MAAM,CAAC;CACrB;AAED,MAAM,WAAW,aAAa;IAC5B,QAAQ,EAAE;QACR,aAAa,EAAE,MAAM,CAAC;QACtB,aAAa,EAAE,MAAM,CAAC;QACtB,gBAAgB,EAAE,MAAM,CAAC;QACzB,qBAAqB,EAAE,MAAM,CAAC;KAC/B,CAAC;IACF,GAAG,EAAE,UAAU,CAAC;IAChB,MAAM,EAAE,UAAU,EAAE,CAAC;IACrB,YAAY,EAAE,gBAAgB,EAAE,CAAC;IACjC,QAAQ,EAAE,OAAO,EAAE,CAAC;IACpB,cAAc,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;CACxC;AAID,MAAM,WAAW,cAAc;IAC7B,KAAK,EAAE,MAAM,CAAC;IACd,+DAA+D;IAC/D,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,yBAAyB;IACzB,QAAQ,CAAC,EAAE,cAAc,CAAC;IAC1B,qBAAqB;IACrB,IAAI,CAAC,EAAE,UAAU,CAAC;IAClB,4BAA4B;IAC5B,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,8CAA8C;IAC9C,YAAY,CAAC,EAAE,OAAO,CAAC;CACxB;AAED,MAAM,WAAW,YAAY;IAC3B,MAAM,EAAE,MAAM,CAAC;IACf,KAAK,EAAE,MAAM,CAAC;IACd,8CAA8C;IAC9C,SAAS,EAAE;QACT,QAAQ,EAAE,MAAM,CAAC;QACjB,aAAa,EAAE,MAAM,CAAC;QACtB,OAAO,EAAE,MAAM,CAAC;QAChB,UAAU,EAAE,MAAM,CAAC;QACnB,gBAAgB,EAAE,MAAM,CAAC;KAC1B,CAAC;CACH;AAID,MAAM,WAAW,cAAc;IAC7B,QAAQ,EAAE,MAAM,CAAC;IACjB,MAAM,EAAE,cAAc,GAAG,cAAc,GAAG,YAAY,GAAG,gBAAgB,GAAG,kBAAkB,CAAC;IAC/F,YAAY,EAAE,MAAM,CAAC;IACrB,YAAY,EAAE,MAAM,CAAC;IACrB,WAAW,EAAE,MAAM,CAAC;CACrB;AAID,MAAM,WAAW,eAAe;IAC9B,OAAO,EAAE,MAAM,CAAC;IAChB,QAAQ,EAAE,cAAc,CAAC;IACzB,YAAY,EAAE,MAAM,EAAE,CAAC;IACvB,IAAI,EAAE,MAAM,EAAE,CAAC;IACf,UAAU,EAAE,MAAM,CAAC;IACnB,SAAS,EAAE,MAAM,GAAG,IAAI,CAAC;CAC1B;AAID,MAAM,WAAW,cAAc;IAC7B,0DAA0D;IAC1D,UAAU,EAAE,MAAM,CAAC;IACnB,yDAAyD;IACzD,eAAe,EAAE,OAAO,CAAC;IACzB,8DAA8D;IAC9D,cAAc,EAAE,MAAM,CAAC;IACvB,oDAAoD;IACpD,UAAU,EAAE,MAAM,CAAC;IACnB,sDAAsD;IACtD,kBAAkB,EAAE,MAAM,CAAC;IAC3B,qDAAqD;IACrD,YAAY,EAAE,MAAM,CAAC;IACrB,kEAAkE;IAClE,cAAc,EAAE,MAAM,EAAE,CAAC;IACzB,qEAAqE;IACrE,MAAM,EAAE,MAAM,CAAC;IACf,8CAA8C;IAC9C,eAAe,EAAE,OAAO,CAAC;IACzB,sEAAsE;IACtE,qBAAqB,EAAE,MAAM,CAAC;IAC9B,uDAAuD;IACvD,SAAS,EAAE,MAAM,CAAC;IAClB,iDAAiD;IACjD,OAAO,EAAE,MAAM,CAAC;CACjB;AAED,6CAA6C;AAC7C,MAAM,MAAM,gBAAgB,GAAG,cAAc,CAAC;AAE9C,eAAO,MAAM,cAAc,EAAE,cAqB5B,CAAC"}

package/dist/types.js

@@ -0,0 +1,24 @@
+// ── Memory Categories ──
+export const DEFAULT_CONFIG = {
+    storageDir: '.teamlens',
+    localEmbeddings: true,
+    embeddingModel: 'nomic-embed-text',
+    ollamaHost: 'http://localhost:11434',
+    stalenessThreshold: 0.6,
+    defaultLimit: 10,
+    ignorePatterns: [
+        'node_modules/**',
+        'dist/**',
+        '.git/**',
+        '*.lock',
+        '*.min.js',
+        '*.min.css',
+        'coverage/**',
+    ],
+    author: 'unknown',
+    sessionTracking: true,
+    sessionTimeoutMinutes: 60,
+    developer: 'unknown',
+    webPort: 3847,
+};
+//# sourceMappingURL=types.js.map

package/dist/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA,0BAA0B;AAwR1B,MAAM,CAAC,MAAM,cAAc,GAAmB;IAC5C,UAAU,EAAE,WAAW;IACvB,eAAe,EAAE,IAAI;IACrB,cAAc,EAAE,kBAAkB;IAClC,UAAU,EAAE,wBAAwB;IACpC,kBAAkB,EAAE,GAAG;IACvB,YAAY,EAAE,EAAE;IAChB,cAAc,EAAE;QACd,iBAAiB;QACjB,SAAS;QACT,SAAS;QACT,QAAQ;QACR,UAAU;QACV,WAAW;QACX,aAAa;KACd;IACD,MAAM,EAAE,SAAS;IACjB,eAAe,EAAE,IAAI;IACrB,qBAAqB,EAAE,EAAE;IACzB,SAAS,EAAE,SAAS;IACpB,OAAO,EAAE,IAAI;CACd,CAAC"}

package/package.json

@@ -0,0 +1,39 @@
+{
+  "name": "@teamlens/core",
+  "version": "0.1.0",
+  "description": "TeamLens core — database, sessions, analytics, team sync",
+  "type": "module",
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/sanketbabar/teamlens",
+    "directory": "packages/core"
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "main": "dist/index.js",
+  "types": "dist/index.d.ts",
+  "files": [
+    "dist/"
+  ],
+  "engines": {
+    "node": ">=20.0.0"
+  },
+  "dependencies": {
+    "chokidar": "^4.0.0",
+    "glob": "^11.0.0",
+    "picomatch": "^4.0.0",
+    "simple-git": "^3.27.0",
+    "sql.js": "^1.11.0"
+  },
+  "devDependencies": {
+    "@types/picomatch": "^3.0.2",
+    "typescript": "^5.7.0"
+  },
+  "scripts": {
+    "build": "tsc",
+    "dev": "tsc --watch",
+    "clean": "rm -rf dist .tsbuildinfo"
+  }
+}