crewly 1.0.0

package/dist/backend/backend/src/types/memory.types.d.ts

@@ -0,0 +1,587 @@
+/**
+ * Memory Data Models for Crewly Two-Level Memory System
+ *
+ * This module defines the data structures for the structured memory system:
+ * - Agent-level memory: Role knowledge, preferences, and performance metrics
+ * - Project-level memory: Patterns, decisions, gotchas, and relationships
+ *
+ * @module memory.types
+ */
+/**
+ * Categories for role knowledge entries
+ */
+export type RoleKnowledgeCategory = 'best-practice' | 'anti-pattern' | 'tool-usage' | 'workflow';
+/**
+ * A single piece of role-specific knowledge learned by an agent
+ *
+ * @example
+ * ```typescript
+ * const entry: RoleKnowledgeEntry = {
+ *   id: 'rk-001',
+ *   category: 'best-practice',
+ *   content: 'Always run tests before committing code changes',
+ *   learnedFrom: 'TICKET-123',
+ *   confidence: 0.85,
+ *   createdAt: '2026-01-29T10:00:00Z',
+ *   lastUsed: '2026-01-29T14:30:00Z'
+ * };
+ * ```
+ */
+export interface RoleKnowledgeEntry {
+    /** Unique identifier for this knowledge entry */
+    id: string;
+    /** Category of knowledge */
+    category: RoleKnowledgeCategory;
+    /** The actual knowledge content */
+    content: string;
+    /** Task/Ticket ID where this was learned (optional) */
+    learnedFrom?: string;
+    /** Confidence score 0-1, increases with reinforcement */
+    confidence: number;
+    /** ISO timestamp when this entry was created */
+    createdAt: string;
+    /** ISO timestamp when this entry was last used/referenced */
+    lastUsed?: string;
+    /** Tags for additional categorization */
+    tags?: string[];
+}
+/**
+ * Verbosity level for agent communication
+ */
+export type VerbosityLevel = 'concise' | 'detailed';
+/**
+ * Task breakdown size preference
+ */
+export type BreakdownSize = 'small' | 'medium' | 'large';
+/**
+ * Agent coding style preferences
+ */
+export interface CodingStylePreferences {
+    /** Preferred programming language */
+    language?: string;
+    /** Preferred testing framework (e.g., 'jest', 'vitest', 'pytest') */
+    testingFramework?: string;
+    /** Linting rules preference (e.g., 'eslint-recommended', 'strict') */
+    lintingRules?: string;
+    /** Code formatting preferences */
+    formatting?: {
+        /** Indentation style ('tabs' or 'spaces') */
+        indentStyle?: 'tabs' | 'spaces';
+        /** Number of spaces for indentation */
+        indentSize?: number;
+        /** Maximum line length */
+        maxLineLength?: number;
+    };
+}
+/**
+ * Agent communication style preferences
+ */
+export interface CommunicationStylePreferences {
+    /** How verbose the agent should be in responses */
+    verbosity: VerbosityLevel;
+    /** Whether to ask for confirmation before taking actions */
+    askBeforeAction: boolean;
+    /** Whether to include explanations with code changes */
+    includeExplanations?: boolean;
+}
+/**
+ * Agent work pattern preferences
+ */
+export interface WorkPatternPreferences {
+    /** How often to commit changes (e.g., 'after-each-task', 'at-milestones') */
+    commitFrequency?: string;
+    /** Preferred size for task breakdown */
+    breakdownSize?: BreakdownSize;
+    /** Preferred working hours (for scheduling) */
+    preferredHours?: {
+        start: string;
+        end: string;
+    };
+}
+/**
+ * Combined agent preferences
+ */
+export interface AgentPreferences {
+    /** Coding style preferences */
+    codingStyle?: CodingStylePreferences;
+    /** Communication style preferences */
+    communicationStyle?: CommunicationStylePreferences;
+    /** Work pattern preferences */
+    workPatterns?: WorkPatternPreferences;
+    /** Custom preferences (key-value pairs) */
+    custom?: Record<string, unknown>;
+}
+/**
+ * A pattern of errors encountered by the agent
+ */
+export interface ErrorPattern {
+    /** Identifier or description of the error pattern */
+    pattern: string;
+    /** Number of times this error has occurred */
+    occurrences: number;
+    /** ISO timestamp of the last occurrence */
+    lastOccurred: string;
+    /** Known resolution for this error (if any) */
+    resolution?: string;
+    /** Related file paths where this error commonly occurs */
+    relatedFiles?: string[];
+}
+/**
+ * Agent performance metrics over time
+ */
+export interface PerformanceMetrics {
+    /** Total number of tasks completed */
+    tasksCompleted: number;
+    /** Average number of iterations per task */
+    averageIterations: number;
+    /** Percentage of quality gates passed on first try (0-100) */
+    qualityGatePassRate: number;
+    /** Common error patterns encountered */
+    commonErrors: ErrorPattern[];
+    /** Average time to complete a task (in minutes) */
+    averageCompletionTime?: number;
+    /** Success rate for different task types */
+    taskTypeSuccessRates?: Record<string, number>;
+}
+/**
+ * Complete agent-level memory structure
+ *
+ * Stored at: ~/.crewly/agents/{agentId}/memory.json
+ *
+ * @example
+ * ```typescript
+ * const agentMemory: AgentMemory = {
+ *   agentId: 'frontend-dev-001',
+ *   role: 'frontend-developer',
+ *   createdAt: '2026-01-01T00:00:00Z',
+ *   updatedAt: '2026-01-29T15:00:00Z',
+ *   roleKnowledge: [...],
+ *   preferences: { ... },
+ *   performance: { ... }
+ * };
+ * ```
+ */
+export interface AgentMemory {
+    /** Unique agent identifier */
+    agentId: string;
+    /** Agent's role (e.g., 'developer', 'qa', 'pm') */
+    role: string;
+    /** ISO timestamp when this memory was created */
+    createdAt: string;
+    /** ISO timestamp of last update */
+    updatedAt: string;
+    /** Role-specific knowledge entries */
+    roleKnowledge: RoleKnowledgeEntry[];
+    /** Agent preferences */
+    preferences: AgentPreferences;
+    /** Performance metrics */
+    performance: PerformanceMetrics;
+    /** Schema version for migration support */
+    schemaVersion?: number;
+}
+/**
+ * Categories for project code patterns
+ */
+export type PatternCategory = 'api' | 'component' | 'service' | 'testing' | 'styling' | 'database' | 'config' | 'other';
+/**
+ * A code pattern discovered in the project
+ *
+ * @example
+ * ```typescript
+ * const pattern: PatternEntry = {
+ *   id: 'pat-001',
+ *   category: 'api',
+ *   title: 'Error Handling Wrapper',
+ *   description: 'All API endpoints use handleApiError() wrapper',
+ *   example: 'app.get("/api/users", handleApiError(async (req, res) => {...}))',
+ *   files: ['backend/src/utils/api-errors.ts'],
+ *   discoveredBy: 'backend-dev-001',
+ *   createdAt: '2026-01-15T10:00:00Z'
+ * };
+ * ```
+ */
+export interface PatternEntry {
+    /** Unique identifier for this pattern */
+    id: string;
+    /** Category of the pattern */
+    category: PatternCategory;
+    /** Short title describing the pattern */
+    title: string;
+    /** Detailed description of the pattern */
+    description: string;
+    /** Code example demonstrating the pattern */
+    example?: string;
+    /** Related file paths */
+    files?: string[];
+    /** Agent ID that discovered this pattern */
+    discoveredBy: string;
+    /** ISO timestamp when discovered */
+    createdAt: string;
+    /** Tags for searchability */
+    tags?: string[];
+}
+/**
+ * An architecture or design decision made for the project
+ *
+ * @example
+ * ```typescript
+ * const decision: DecisionEntry = {
+ *   id: 'dec-001',
+ *   title: 'State Management Choice',
+ *   decision: 'Use React Context API instead of Redux',
+ *   rationale: 'Project scope is small, Redux would add unnecessary complexity',
+ *   alternatives: ['Redux', 'MobX', 'Zustand'],
+ *   decidedBy: 'tech-lead',
+ *   decidedAt: '2026-01-10T14:00:00Z',
+ *   affectedAreas: ['frontend/src/contexts/', 'frontend/src/components/']
+ * };
+ * ```
+ */
+export interface DecisionEntry {
+    /** Unique identifier for this decision */
+    id: string;
+    /** Short title of the decision */
+    title: string;
+    /** The actual decision made */
+    decision: string;
+    /** Why this decision was made */
+    rationale: string;
+    /** Other options that were considered */
+    alternatives?: string[];
+    /** Who made this decision (agent ID or 'user') */
+    decidedBy: string;
+    /** ISO timestamp when decided */
+    decidedAt: string;
+    /** Areas of the codebase affected by this decision */
+    affectedAreas?: string[];
+    /** Current status of the decision */
+    status?: 'active' | 'superseded' | 'deprecated';
+    /** ID of the decision that supersedes this one */
+    supersededBy?: string;
+    /** What actually happened (filled retrospectively) */
+    actualOutcome?: string;
+    /** What was learned from this decision */
+    learnings?: string;
+    /** ISO timestamp when the outcome was recorded */
+    outcomeRecordedAt?: string;
+}
+/**
+ * Severity levels for gotcha entries
+ */
+export type GotchaSeverity = 'low' | 'medium' | 'high' | 'critical';
+/**
+ * A known issue or workaround in the project
+ *
+ * @example
+ * ```typescript
+ * const gotcha: GotchaEntry = {
+ *   id: 'got-001',
+ *   title: 'PostgreSQL connection pool exhaustion',
+ *   problem: 'Database connections leak when using transactions without proper cleanup',
+ *   solution: 'Always use try/finally with client.release() or use pool.query() for single queries',
+ *   severity: 'high',
+ *   discoveredBy: 'backend-dev-001',
+ *   createdAt: '2026-01-20T09:00:00Z'
+ * };
+ * ```
+ */
+export interface GotchaEntry {
+    /** Unique identifier for this gotcha */
+    id: string;
+    /** Short title of the issue */
+    title: string;
+    /** Description of the problem */
+    problem: string;
+    /** Known solution or workaround */
+    solution: string;
+    /** How severe is this issue */
+    severity: GotchaSeverity;
+    /** Agent ID that discovered this */
+    discoveredBy: string;
+    /** ISO timestamp when discovered */
+    createdAt: string;
+    /** Related file paths */
+    relatedFiles?: string[];
+    /** Whether this gotcha is still relevant */
+    resolved?: boolean;
+    /** ISO timestamp when resolved */
+    resolvedAt?: string;
+}
+/**
+ * Types of relationships between components
+ */
+export type RelationshipType = 'depends-on' | 'uses' | 'extends' | 'implements' | 'calls' | 'imported-by';
+/**
+ * A relationship between two components/services in the project
+ *
+ * @example
+ * ```typescript
+ * const relationship: RelationshipEntry = {
+ *   id: 'rel-001',
+ *   from: 'UserController',
+ *   to: 'AuthService',
+ *   relationshipType: 'depends-on',
+ *   description: 'UserController requires AuthService for authentication checks'
+ * };
+ * ```
+ */
+export interface RelationshipEntry {
+    /** Unique identifier for this relationship */
+    id: string;
+    /** Source component/service name */
+    from: string;
+    /** Target component/service name */
+    to: string;
+    /** Type of relationship */
+    relationshipType: RelationshipType;
+    /** Optional description of the relationship */
+    description?: string;
+    /** File path of the source component */
+    fromFile?: string;
+    /** File path of the target component */
+    toFile?: string;
+}
+/**
+ * Complete project-level memory structure
+ *
+ * Stored at: project/.crewly/knowledge/index.json
+ *
+ * @example
+ * ```typescript
+ * const projectMemory: ProjectMemory = {
+ *   projectId: 'proj-001',
+ *   projectPath: '/home/user/projects/my-app',
+ *   createdAt: '2026-01-01T00:00:00Z',
+ *   updatedAt: '2026-01-29T15:00:00Z',
+ *   patterns: [...],
+ *   decisions: [...],
+ *   gotchas: [...],
+ *   relationships: [...]
+ * };
+ * ```
+ */
+export interface ProjectMemory {
+    /** Unique project identifier */
+    projectId: string;
+    /** Absolute path to the project directory */
+    projectPath: string;
+    /** ISO timestamp when this memory was created */
+    createdAt: string;
+    /** ISO timestamp of last update */
+    updatedAt: string;
+    /** Code patterns discovered in the project */
+    patterns: PatternEntry[];
+    /** Architecture and design decisions */
+    decisions: DecisionEntry[];
+    /** Known issues and workarounds */
+    gotchas: GotchaEntry[];
+    /** Component/service relationships */
+    relationships: RelationshipEntry[];
+    /** Schema version for migration support */
+    schemaVersion?: number;
+}
+/**
+ * Categories for learning entries
+ */
+export type LearningCategory = 'pattern' | 'decision' | 'gotcha' | 'insight' | 'improvement';
+/**
+ * A single learning entry for the append-only log
+ *
+ * This is used for the human-readable learnings.md file
+ */
+export interface LearningEntry {
+    /** ISO timestamp of the learning */
+    timestamp: string;
+    /** Agent ID that recorded this learning */
+    agentId: string;
+    /** Agent's role */
+    agentRole: string;
+    /** Category of learning */
+    category: LearningCategory;
+    /** Title of the learning */
+    title: string;
+    /** Content of the learning */
+    content: string;
+    /** Related file paths */
+    relatedFiles?: string[];
+    /** Related task/ticket ID */
+    relatedTask?: string;
+}
+/**
+ * Summary of an agent's work session, captured on session end
+ */
+export interface SessionSummary {
+    /** Agent identifier */
+    agentId: string;
+    /** ISO timestamp when the session started */
+    sessionStart: string;
+    /** ISO timestamp when the session ended */
+    sessionEnd: string;
+    /** Human-readable summary of what was accomplished */
+    summary: string;
+    /** Description of unfinished work to pick up next session */
+    unfinishedWork?: string;
+    /** Agent's role during this session */
+    role?: string;
+    /** Project path for this session */
+    projectPath?: string;
+}
+/**
+ * Briefing assembled for an agent at session startup
+ */
+export interface StartupBriefing {
+    /** Summary from the agent's most recent session (if any) */
+    lastSessionSummary: string | null;
+    /** Agent-level context (knowledge, preferences, performance) */
+    agentContext: string;
+    /** Project-level context (patterns, decisions, gotchas) */
+    projectContext: string;
+    /** Today's daily log entries (if any) */
+    todaysDailyLog: string | null;
+    /** Active goals for the project (if any) */
+    activeGoals: string | null;
+    /** Recent failures to avoid repeating */
+    recentFailures: string | null;
+    /** Recent successes to replicate */
+    recentSuccesses: string | null;
+}
+/**
+ * Entry in the project agents index, tracking which agents have worked on a project
+ */
+export interface AgentIndexEntry {
+    /** Agent identifier */
+    agentId: string;
+    /** Agent's role */
+    role: string;
+    /** ISO timestamp of last activity */
+    lastActive: string;
+}
+/**
+ * Project agents index file structure
+ */
+export interface ProjectAgentsIndex {
+    /** List of agents that have worked on this project */
+    agents: AgentIndexEntry[];
+}
+/**
+ * Entry in the daily log
+ */
+export interface DailyLogEntry {
+    /** ISO timestamp */
+    timestamp: string;
+    /** Agent identifier */
+    agentId: string;
+    /** Agent's role */
+    role: string;
+    /** Log entry content */
+    entry: string;
+}
+/**
+ * A learning entry categorized as success or failure
+ */
+export interface LearningAccumulationEntry {
+    /** ISO timestamp when recorded */
+    timestamp: string;
+    /** Agent that recorded this */
+    agentId: string;
+    /** Agent's role */
+    role: string;
+    /** Description of what worked or failed */
+    description: string;
+    /** Related context (file paths, task IDs, etc.) */
+    context?: string;
+}
+/**
+ * Scope for memory operations
+ */
+export type MemoryScope = 'agent' | 'project';
+/**
+ * Options for querying memory
+ */
+export interface MemoryQueryOptions {
+    /** Scope of the query */
+    scope: MemoryScope;
+    /** Category filter */
+    category?: string;
+    /** Tag filter */
+    tags?: string[];
+    /** Minimum confidence threshold (for agent memory) */
+    minConfidence?: number;
+    /** Maximum number of results */
+    limit?: number;
+    /** Search text for content matching */
+    searchText?: string;
+    /** Only return entries after this date */
+    since?: string;
+}
+/**
+ * Result of a memory query
+ */
+export interface MemoryQueryResult<T> {
+    /** The matching entries */
+    entries: T[];
+    /** Total count (may be more than entries if limited) */
+    totalCount: number;
+    /** Whether there are more results */
+    hasMore: boolean;
+}
+/**
+ * Options for storing memory
+ */
+export interface MemoryStoreOptions {
+    /** Scope for storage */
+    scope: MemoryScope;
+    /** Whether to merge with existing entry if ID exists */
+    merge?: boolean;
+    /** Whether to update the 'updatedAt' timestamp */
+    updateTimestamp?: boolean;
+}
+/**
+ * Agent memory file structure
+ *
+ * Location: ~/.crewly/agents/{agentId}/
+ */
+export interface AgentMemoryFileStructure {
+    /** Main memory file containing AgentMemory */
+    memoryFile: 'memory.json';
+    /** Detailed role knowledge entries */
+    roleKnowledgeFile: 'role-knowledge.json';
+    /** Agent preferences */
+    preferencesFile: 'preferences.json';
+    /** Performance metrics */
+    performanceFile: 'performance.json';
+    /** Custom SOPs directory */
+    sopCustomDir: 'sop-custom';
+}
+/**
+ * Project memory file structure
+ *
+ * Location: project/.crewly/knowledge/
+ */
+export interface ProjectMemoryFileStructure {
+    /** Main index file containing ProjectMemory summary */
+    indexFile: 'index.json';
+    /** All pattern entries */
+    patternsFile: 'patterns.json';
+    /** All decision entries */
+    decisionsFile: 'decisions.json';
+    /** All gotcha entries */
+    gotchasFile: 'gotchas.json';
+    /** All relationship entries */
+    relationshipsFile: 'relationships.json';
+    /** Append-only human-readable log */
+    learningsFile: 'learnings.md';
+}
+/**
+ * Default values for new agent memory
+ */
+export declare const DEFAULT_AGENT_MEMORY: Omit<AgentMemory, 'agentId' | 'role' | 'createdAt' | 'updatedAt'>;
+/**
+ * Default values for new project memory
+ */
+export declare const DEFAULT_PROJECT_MEMORY: Omit<ProjectMemory, 'projectId' | 'projectPath' | 'createdAt' | 'updatedAt'>;
+/**
+ * Current schema version for memory files
+ */
+export declare const MEMORY_SCHEMA_VERSION = 1;
+//# sourceMappingURL=memory.types.d.ts.map

package/dist/backend/backend/src/types/memory.types.d.ts.map

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

package/dist/backend/backend/src/types/memory.types.js

@@ -0,0 +1,47 @@
+/**
+ * Memory Data Models for Crewly Two-Level Memory System
+ *
+ * This module defines the data structures for the structured memory system:
+ * - Agent-level memory: Role knowledge, preferences, and performance metrics
+ * - Project-level memory: Patterns, decisions, gotchas, and relationships
+ *
+ * @module memory.types
+ */
+// ========================= VALIDATION AND DEFAULTS =========================
+/**
+ * Default values for new agent memory
+ */
+export const DEFAULT_AGENT_MEMORY = {
+    roleKnowledge: [],
+    preferences: {
+        communicationStyle: {
+            verbosity: 'detailed',
+            askBeforeAction: true,
+        },
+        workPatterns: {
+            breakdownSize: 'medium',
+        },
+    },
+    performance: {
+        tasksCompleted: 0,
+        averageIterations: 0,
+        qualityGatePassRate: 0,
+        commonErrors: [],
+    },
+    schemaVersion: 1,
+};
+/**
+ * Default values for new project memory
+ */
+export const DEFAULT_PROJECT_MEMORY = {
+    patterns: [],
+    decisions: [],
+    gotchas: [],
+    relationships: [],
+    schemaVersion: 1,
+};
+/**
+ * Current schema version for memory files
+ */
+export const MEMORY_SCHEMA_VERSION = 1;
+//# sourceMappingURL=memory.types.js.map

package/dist/backend/backend/src/types/memory.types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"memory.types.js","sourceRoot":"","sources":["../../../../../backend/src/types/memory.types.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAomBH,8EAA8E;AAE9E;;GAEG;AACH,MAAM,CAAC,MAAM,oBAAoB,GAAsE;IACrG,aAAa,EAAE,EAAE;IACjB,WAAW,EAAE;QACX,kBAAkB,EAAE;YAClB,SAAS,EAAE,UAAU;YACrB,eAAe,EAAE,IAAI;SACtB;QACD,YAAY,EAAE;YACZ,aAAa,EAAE,QAAQ;SACxB;KACF;IACD,WAAW,EAAE;QACX,cAAc,EAAE,CAAC;QACjB,iBAAiB,EAAE,CAAC;QACpB,mBAAmB,EAAE,CAAC;QACtB,YAAY,EAAE,EAAE;KACjB;IACD,aAAa,EAAE,CAAC;CACjB,CAAC;AAEF;;GAEG;AACH,MAAM,CAAC,MAAM,sBAAsB,GAAiF;IAClH,QAAQ,EAAE,EAAE;IACZ,SAAS,EAAE,EAAE;IACb,OAAO,EAAE,EAAE;IACX,aAAa,EAAE,EAAE;IACjB,aAAa,EAAE,CAAC;CACjB,CAAC;AAEF;;GAEG;AACH,MAAM,CAAC,MAAM,qBAAqB,GAAG,CAAC,CAAC"}