crewly 1.0.0

package/dist/backend/backend/src/services/marketplace/marketplace.service.d.ts

@@ -0,0 +1,101 @@
+/**
+ * Marketplace Service
+ *
+ * Handles fetching the marketplace registry from the Crewly webapp API,
+ * managing the local installed-items manifest, and enriching items
+ * with install status information.
+ *
+ * @module services/marketplace/marketplace.service
+ */
+import { MarketplaceRegistry, MarketplaceItemWithStatus, MarketplaceFilter, InstalledItemsManifest, InstalledItemRecord } from '../../types/marketplace.types.js';
+/**
+ * Fetches the marketplace registry from the Crewly webapp API.
+ * Uses in-memory caching with a 1-hour TTL.
+ *
+ * On network failure, falls back to the previously cached registry
+ * if one is available. Throws only when no cached data exists.
+ *
+ * @param forceRefresh - If true, bypasses the cache and fetches fresh data
+ * @returns The marketplace registry containing all available items
+ * @throws Error if the fetch fails and no cached registry is available
+ */
+export declare function fetchRegistry(forceRefresh?: boolean): Promise<MarketplaceRegistry>;
+/**
+ * Loads the locally installed items manifest from disk.
+ *
+ * Returns an empty manifest (schemaVersion 1, no items) if the
+ * manifest file does not exist or cannot be parsed.
+ *
+ * @returns The installed items manifest
+ */
+export declare function loadManifest(): Promise<InstalledItemsManifest>;
+/**
+ * Saves the installed items manifest to disk.
+ *
+ * Creates the marketplace directory if it does not exist.
+ *
+ * @param manifest - The manifest to persist
+ */
+export declare function saveManifest(manifest: InstalledItemsManifest): Promise<void>;
+/**
+ * Returns a single marketplace item by ID, enriched with install status.
+ *
+ * @param id - The marketplace item ID to look up
+ * @returns The item with install status, or null if not found in the registry
+ */
+export declare function getItem(id: string): Promise<MarketplaceItemWithStatus | null>;
+/**
+ * Lists marketplace items with optional filtering, enriched with install status.
+ *
+ * Supports filtering by type, category, and free-text search (matches name,
+ * description, and tags). Results are sorted by the specified sort option,
+ * defaulting to most popular (highest downloads).
+ *
+ * @param filter - Optional filter and sort criteria
+ * @returns Filtered and sorted list of items with install status
+ */
+export declare function listItems(filter?: MarketplaceFilter): Promise<MarketplaceItemWithStatus[]>;
+/**
+ * Returns marketplace items that have updates available.
+ *
+ * An item has an update available when the installed version differs
+ * from the latest version in the registry.
+ *
+ * @returns Items with installStatus 'update_available'
+ */
+export declare function getUpdatableItems(): Promise<MarketplaceItemWithStatus[]>;
+/**
+ * Returns locally installed items from the manifest.
+ *
+ * @returns Array of installed item records
+ */
+export declare function getInstalledItems(): Promise<InstalledItemRecord[]>;
+/**
+ * Searches marketplace items by query string.
+ *
+ * Convenience wrapper around listItems with a search filter.
+ *
+ * @param query - Free-text search query
+ * @returns Matching items with install status
+ */
+export declare function searchItems(query: string): Promise<MarketplaceItemWithStatus[]>;
+/**
+ * Returns the local install path for a marketplace item.
+ *
+ * Maps item types to directory names:
+ * - 'skill' -> 'skills'
+ * - 'model' -> 'models'
+ * - 'role'  -> 'roles'
+ *
+ * @param type - The marketplace item type
+ * @param id - The marketplace item ID
+ * @returns Absolute path to the item's install directory
+ */
+export declare function getInstallPath(type: string, id: string): string;
+/**
+ * Resets the in-memory registry cache.
+ *
+ * Used primarily for testing to ensure a clean state between test runs.
+ */
+export declare function resetRegistryCache(): void;
+//# sourceMappingURL=marketplace.service.d.ts.map

package/dist/backend/backend/src/services/marketplace/marketplace.service.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"marketplace.service.d.ts","sourceRoot":"","sources":["../../../../../../backend/src/services/marketplace/marketplace.service.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAKH,OAAO,EACL,mBAAmB,EAEnB,yBAAyB,EACzB,iBAAiB,EACjB,sBAAsB,EACtB,mBAAmB,EACpB,MAAM,kCAAkC,CAAC;AAa1C;;;;;;;;;;GAUG;AACH,wBAAsB,aAAa,CAAC,YAAY,UAAQ,GAAG,OAAO,CAAC,mBAAmB,CAAC,CAgBtF;AAED;;;;;;;GAOG;AACH,wBAAsB,YAAY,IAAI,OAAO,CAAC,sBAAsB,CAAC,CAOpE;AAED;;;;;;GAMG;AACH,wBAAsB,YAAY,CAAC,QAAQ,EAAE,sBAAsB,GAAG,OAAO,CAAC,IAAI,CAAC,CAGlF;AAED;;;;;GAKG;AACH,wBAAsB,OAAO,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,yBAAyB,GAAG,IAAI,CAAC,CAKnF;AAED;;;;;;;;;GASG;AACH,wBAAsB,SAAS,CAAC,MAAM,CAAC,EAAE,iBAAiB,GAAG,OAAO,CAAC,yBAAyB,EAAE,CAAC,CAoChG;AAED;;;;;;;GAOG;AACH,wBAAsB,iBAAiB,IAAI,OAAO,CAAC,yBAAyB,EAAE,CAAC,CAG9E;AAED;;;;GAIG;AACH,wBAAsB,iBAAiB,IAAI,OAAO,CAAC,mBAAmB,EAAE,CAAC,CAGxE;AAED;;;;;;;GAOG;AACH,wBAAsB,WAAW,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,yBAAyB,EAAE,CAAC,CAErF;AA0BD;;;;;;;;;;;GAWG;AACH,wBAAgB,cAAc,CAAC,IAAI,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,GAAG,MAAM,CAG/D;AAED;;;;GAIG;AACH,wBAAgB,kBAAkB,IAAI,IAAI,CAGzC"}

package/dist/backend/backend/src/services/marketplace/marketplace.service.js

@@ -0,0 +1,207 @@
+/**
+ * Marketplace Service
+ *
+ * Handles fetching the marketplace registry from the Crewly webapp API,
+ * managing the local installed-items manifest, and enriching items
+ * with install status information.
+ *
+ * @module services/marketplace/marketplace.service
+ */
+import { homedir } from 'os';
+import path from 'path';
+import { readFile, writeFile, mkdir } from 'fs/promises';
+const MARKETPLACE_BASE_URL = 'https://crewly.stevesprompt.com';
+const REGISTRY_ENDPOINT = '/api/registry';
+const CACHE_TTL = 60 * 60 * 1000; // 1 hour
+const CREWLY_HOME = path.join(homedir(), '.crewly');
+const MARKETPLACE_DIR = path.join(CREWLY_HOME, 'marketplace');
+const MANIFEST_PATH = path.join(MARKETPLACE_DIR, 'manifest.json');
+let cachedRegistry = null;
+let cacheTimestamp = 0;
+/**
+ * Fetches the marketplace registry from the Crewly webapp API.
+ * Uses in-memory caching with a 1-hour TTL.
+ *
+ * On network failure, falls back to the previously cached registry
+ * if one is available. Throws only when no cached data exists.
+ *
+ * @param forceRefresh - If true, bypasses the cache and fetches fresh data
+ * @returns The marketplace registry containing all available items
+ * @throws Error if the fetch fails and no cached registry is available
+ */
+export async function fetchRegistry(forceRefresh = false) {
+    const now = Date.now();
+    if (!forceRefresh && cachedRegistry && now - cacheTimestamp < CACHE_TTL) {
+        return cachedRegistry;
+    }
+    const url = `${MARKETPLACE_BASE_URL}${REGISTRY_ENDPOINT}`;
+    const res = await fetch(url);
+    if (!res.ok) {
+        if (cachedRegistry)
+            return cachedRegistry;
+        throw new Error(`Failed to fetch registry: ${res.status} ${res.statusText}`);
+    }
+    cachedRegistry = (await res.json());
+    cacheTimestamp = now;
+    return cachedRegistry;
+}
+/**
+ * Loads the locally installed items manifest from disk.
+ *
+ * Returns an empty manifest (schemaVersion 1, no items) if the
+ * manifest file does not exist or cannot be parsed.
+ *
+ * @returns The installed items manifest
+ */
+export async function loadManifest() {
+    try {
+        const data = await readFile(MANIFEST_PATH, 'utf-8');
+        return JSON.parse(data);
+    }
+    catch {
+        return { schemaVersion: 1, items: [] };
+    }
+}
+/**
+ * Saves the installed items manifest to disk.
+ *
+ * Creates the marketplace directory if it does not exist.
+ *
+ * @param manifest - The manifest to persist
+ */
+export async function saveManifest(manifest) {
+    await mkdir(MARKETPLACE_DIR, { recursive: true });
+    await writeFile(MANIFEST_PATH, JSON.stringify(manifest, null, 2) + '\n');
+}
+/**
+ * Returns a single marketplace item by ID, enriched with install status.
+ *
+ * @param id - The marketplace item ID to look up
+ * @returns The item with install status, or null if not found in the registry
+ */
+export async function getItem(id) {
+    const registry = await fetchRegistry();
+    const item = registry.items.find((i) => i.id === id);
+    if (!item)
+        return null;
+    return enrichWithStatus(item, await loadManifest());
+}
+/**
+ * Lists marketplace items with optional filtering, enriched with install status.
+ *
+ * Supports filtering by type, category, and free-text search (matches name,
+ * description, and tags). Results are sorted by the specified sort option,
+ * defaulting to most popular (highest downloads).
+ *
+ * @param filter - Optional filter and sort criteria
+ * @returns Filtered and sorted list of items with install status
+ */
+export async function listItems(filter) {
+    const registry = await fetchRegistry();
+    let items = registry.items;
+    if (filter?.type) {
+        items = items.filter((i) => i.type === filter.type);
+    }
+    if (filter?.category) {
+        items = items.filter((i) => i.category === filter.category);
+    }
+    if (filter?.search) {
+        const q = filter.search.toLowerCase();
+        items = items.filter((i) => i.name.toLowerCase().includes(q) ||
+            i.description.toLowerCase().includes(q) ||
+            i.tags.some((t) => t.toLowerCase().includes(q)));
+    }
+    switch (filter?.sortBy) {
+        case 'popular':
+            items.sort((a, b) => b.downloads - a.downloads);
+            break;
+        case 'rating':
+            items.sort((a, b) => b.rating - a.rating);
+            break;
+        case 'newest':
+            items.sort((a, b) => new Date(b.createdAt).getTime() - new Date(a.createdAt).getTime());
+            break;
+        default:
+            items.sort((a, b) => b.downloads - a.downloads);
+    }
+    const manifest = await loadManifest();
+    return items.map((i) => enrichWithStatus(i, manifest));
+}
+/**
+ * Returns marketplace items that have updates available.
+ *
+ * An item has an update available when the installed version differs
+ * from the latest version in the registry.
+ *
+ * @returns Items with installStatus 'update_available'
+ */
+export async function getUpdatableItems() {
+    const all = await listItems();
+    return all.filter((i) => i.installStatus === 'update_available');
+}
+/**
+ * Returns locally installed items from the manifest.
+ *
+ * @returns Array of installed item records
+ */
+export async function getInstalledItems() {
+    const manifest = await loadManifest();
+    return manifest.items;
+}
+/**
+ * Searches marketplace items by query string.
+ *
+ * Convenience wrapper around listItems with a search filter.
+ *
+ * @param query - Free-text search query
+ * @returns Matching items with install status
+ */
+export async function searchItems(query) {
+    return listItems({ search: query });
+}
+/**
+ * Enriches a marketplace item with its local install status.
+ *
+ * Compares the registry item against the local manifest to determine
+ * whether the item is not installed, installed, or has an update available.
+ *
+ * @param item - The marketplace item from the registry
+ * @param manifest - The local installed items manifest
+ * @returns The item enriched with installStatus and optional installedVersion
+ */
+function enrichWithStatus(item, manifest) {
+    const installed = manifest.items.find((r) => r.id === item.id);
+    if (!installed) {
+        return { ...item, installStatus: 'not_installed' };
+    }
+    if (installed.version !== item.version) {
+        return { ...item, installStatus: 'update_available', installedVersion: installed.version };
+    }
+    return { ...item, installStatus: 'installed', installedVersion: installed.version };
+}
+/**
+ * Returns the local install path for a marketplace item.
+ *
+ * Maps item types to directory names:
+ * - 'skill' -> 'skills'
+ * - 'model' -> 'models'
+ * - 'role'  -> 'roles'
+ *
+ * @param type - The marketplace item type
+ * @param id - The marketplace item ID
+ * @returns Absolute path to the item's install directory
+ */
+export function getInstallPath(type, id) {
+    const typeDir = type === 'skill' ? 'skills' : type === 'model' ? 'models' : 'roles';
+    return path.join(MARKETPLACE_DIR, typeDir, id);
+}
+/**
+ * Resets the in-memory registry cache.
+ *
+ * Used primarily for testing to ensure a clean state between test runs.
+ */
+export function resetRegistryCache() {
+    cachedRegistry = null;
+    cacheTimestamp = 0;
+}
+//# sourceMappingURL=marketplace.service.js.map

package/dist/backend/backend/src/services/marketplace/marketplace.service.js.map

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

package/dist/backend/backend/src/services/memory/agent-memory.service.d.ts

@@ -0,0 +1,259 @@
+/**
+ * Agent Memory Service
+ *
+ * Manages agent-level persistent memory stored in ~/.crewly/agents/{agentId}/
+ * Provides storage for role knowledge, preferences, and performance metrics.
+ *
+ * @module services/memory/agent-memory.service
+ */
+import { AgentMemory, AgentPreferences, RoleKnowledgeEntry, PerformanceMetrics, type RoleKnowledgeCategory } from '../../types/memory.types.js';
+/**
+ * Metrics recorded when a task is completed
+ */
+export interface TaskCompletionMetrics {
+    /** Number of iterations to complete the task */
+    iterations: number;
+    /** Whether quality gates passed on first try */
+    qualityGatePassed: boolean;
+    /** Time to complete in minutes */
+    completionTimeMinutes?: number;
+    /** Type of task (e.g., 'bug-fix', 'feature', 'refactor') */
+    taskType?: string;
+}
+/**
+ * Interface for the Agent Memory Service
+ */
+export interface IAgentMemoryService {
+    initializeAgent(agentId: string, role: string): Promise<void>;
+    addRoleKnowledge(agentId: string, entry: Omit<RoleKnowledgeEntry, 'id' | 'createdAt'>): Promise<string>;
+    getRoleKnowledge(agentId: string, category?: RoleKnowledgeCategory): Promise<RoleKnowledgeEntry[]>;
+    reinforceKnowledge(agentId: string, entryId: string): Promise<void>;
+    updatePreferences(agentId: string, preferences: Partial<AgentPreferences>): Promise<void>;
+    getPreferences(agentId: string): Promise<AgentPreferences>;
+    recordTaskCompletion(agentId: string, metrics: TaskCompletionMetrics): Promise<void>;
+    recordError(agentId: string, errorPattern: string, resolution?: string): Promise<void>;
+    getPerformanceMetrics(agentId: string): Promise<PerformanceMetrics>;
+    generateAgentContext(agentId: string): Promise<string>;
+    pruneStaleEntries(agentId: string, olderThanDays: number): Promise<number>;
+    getAgentMemory(agentId: string): Promise<AgentMemory | null>;
+}
+/**
+ * Service for managing agent-level persistent memory
+ *
+ * Follows singleton pattern for consistent state management.
+ * Uses atomic file writes to prevent data corruption.
+ *
+ * @example
+ * ```typescript
+ * const memoryService = AgentMemoryService.getInstance();
+ * await memoryService.initializeAgent('dev-001', 'developer');
+ * await memoryService.addRoleKnowledge('dev-001', {
+ *   category: 'best-practice',
+ *   content: 'Always run tests before committing',
+ *   confidence: 0.5
+ * });
+ * ```
+ */
+export declare class AgentMemoryService implements IAgentMemoryService {
+    private static instance;
+    private static instanceHome;
+    private readonly basePath;
+    private readonly logger;
+    private readonly memoryCache;
+    private readonly CACHE_TTL_MS;
+    /**
+     * Creates a new AgentMemoryService instance
+     *
+     * @param crewlyHome - Optional custom path for crewly home directory
+     */
+    constructor(crewlyHome?: string);
+    /**
+     * Gets the singleton instance of AgentMemoryService
+     *
+     * @param crewlyHome - Optional custom path for crewly home directory
+     * @returns The singleton AgentMemoryService instance
+     */
+    static getInstance(crewlyHome?: string): AgentMemoryService;
+    /**
+     * Clears the singleton instance (useful for testing)
+     */
+    static clearInstance(): void;
+    /**
+     * Ensures the base agents directory exists
+     */
+    private ensureBaseDirectory;
+    /**
+     * Gets the path to an agent's memory directory
+     *
+     * @param agentId - The agent's unique identifier
+     * @returns Absolute path to the agent's memory directory
+     */
+    private getAgentPath;
+    /**
+     * Gets the path to a specific memory file for an agent
+     *
+     * @param agentId - The agent's unique identifier
+     * @param fileName - The memory file name
+     * @returns Absolute path to the memory file
+     */
+    private getFilePath;
+    /**
+     * Ensures an agent's directory structure exists
+     *
+     * @param agentId - The agent's unique identifier
+     */
+    private ensureAgentDirectory;
+    /**
+     * Invalidates the cache for an agent
+     *
+     * @param agentId - The agent's unique identifier
+     */
+    private invalidateCache;
+    /**
+     * Gets cached agent memory or loads from disk
+     *
+     * @param agentId - The agent's unique identifier
+     * @returns Agent memory or null if not found
+     */
+    private getCachedMemory;
+    /**
+     * Loads agent memory from disk
+     *
+     * @param agentId - The agent's unique identifier
+     * @returns Agent memory or null if not initialized
+     */
+    private loadAgentMemory;
+    /**
+     * Saves agent memory to disk
+     *
+     * @param agentId - The agent's unique identifier
+     * @param memory - Memory data to save
+     */
+    private saveAgentMemory;
+    /**
+     * Finds a similar existing knowledge entry to avoid duplicates
+     *
+     * @param knowledge - Existing knowledge entries
+     * @param content - Content to check for similarity
+     * @returns Matching entry or undefined
+     */
+    private findSimilarEntry;
+    /**
+     * Formats agent preferences for context output
+     *
+     * @param preferences - Agent preferences to format
+     * @returns Formatted string
+     */
+    private formatPreferences;
+    /**
+     * Initializes memory storage for a new agent
+     *
+     * @param agentId - Unique identifier for the agent
+     * @param role - Agent's role (e.g., 'developer', 'qa', 'pm')
+     *
+     * @example
+     * ```typescript
+     * await memoryService.initializeAgent('frontend-dev-001', 'frontend-developer');
+     * ```
+     */
+    initializeAgent(agentId: string, role: string): Promise<void>;
+    /**
+     * Adds a new role knowledge entry
+     *
+     * If similar content already exists, reinforces the existing entry instead.
+     *
+     * @param agentId - Agent's unique identifier
+     * @param entry - Knowledge entry (without id and createdAt)
+     * @returns ID of the created or reinforced entry
+     *
+     * @example
+     * ```typescript
+     * const entryId = await memoryService.addRoleKnowledge('dev-001', {
+     *   category: 'best-practice',
+     *   content: 'Always validate user input before processing',
+     *   confidence: 0.6,
+     *   learnedFrom: 'TICKET-456'
+     * });
+     * ```
+     */
+    addRoleKnowledge(agentId: string, entry: Omit<RoleKnowledgeEntry, 'id' | 'createdAt'>): Promise<string>;
+    /**
+     * Gets role knowledge entries, optionally filtered by category
+     *
+     * @param agentId - Agent's unique identifier
+     * @param category - Optional category filter
+     * @returns Array of knowledge entries sorted by confidence (descending)
+     */
+    getRoleKnowledge(agentId: string, category?: RoleKnowledgeCategory): Promise<RoleKnowledgeEntry[]>;
+    /**
+     * Reinforces a knowledge entry by increasing its confidence
+     *
+     * @param agentId - Agent's unique identifier
+     * @param entryId - ID of the entry to reinforce
+     */
+    reinforceKnowledge(agentId: string, entryId: string): Promise<void>;
+    /**
+     * Updates agent preferences (partial update supported)
+     *
+     * @param agentId - Agent's unique identifier
+     * @param preferences - Partial preferences to update
+     */
+    updatePreferences(agentId: string, preferences: Partial<AgentPreferences>): Promise<void>;
+    /**
+     * Gets the current agent preferences
+     *
+     * @param agentId - Agent's unique identifier
+     * @returns Agent preferences or defaults
+     */
+    getPreferences(agentId: string): Promise<AgentPreferences>;
+    /**
+     * Records a task completion and updates performance metrics
+     *
+     * @param agentId - Agent's unique identifier
+     * @param metrics - Task completion metrics
+     */
+    recordTaskCompletion(agentId: string, metrics: TaskCompletionMetrics): Promise<void>;
+    /**
+     * Records an error pattern encountered by the agent
+     *
+     * @param agentId - Agent's unique identifier
+     * @param errorPattern - Description of the error pattern
+     * @param resolution - Optional known resolution
+     */
+    recordError(agentId: string, errorPattern: string, resolution?: string): Promise<void>;
+    /**
+     * Gets the current performance metrics for an agent
+     *
+     * @param agentId - Agent's unique identifier
+     * @returns Performance metrics
+     */
+    getPerformanceMetrics(agentId: string): Promise<PerformanceMetrics>;
+    /**
+     * Generates a context string for prompt injection
+     *
+     * Compiles relevant agent memories, preferences, and performance data
+     * into a formatted string suitable for inclusion in agent prompts.
+     *
+     * @param agentId - Agent's unique identifier
+     * @returns Formatted context string
+     */
+    generateAgentContext(agentId: string): Promise<string>;
+    /**
+     * Prunes stale entries older than specified days
+     *
+     * Removes low-confidence entries that haven't been used recently.
+     *
+     * @param agentId - Agent's unique identifier
+     * @param olderThanDays - Number of days threshold
+     * @returns Number of entries removed
+     */
+    pruneStaleEntries(agentId: string, olderThanDays: number): Promise<number>;
+    /**
+     * Gets the complete agent memory object
+     *
+     * @param agentId - Agent's unique identifier
+     * @returns Full agent memory or null if not initialized
+     */
+    getAgentMemory(agentId: string): Promise<AgentMemory | null>;
+}
+//# sourceMappingURL=agent-memory.service.d.ts.map

package/dist/backend/backend/src/services/memory/agent-memory.service.d.ts.map

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