crewly 1.5.17 → 1.5.19

package/dist/backend/backend/src/services/onboarding/onboarding-provision.types.js

@@ -0,0 +1,163 @@
+/**
+ * Onboarding Provision Types
+ *
+ * Interface contract between the Onboarding Agent (Strategy) and the
+ * Template Engine (Product). Defines the JSON handoff format that bridges
+ * Ethan's Onboarding Agent Framework v1.1 discovery output to our
+ * TemplateService.createTeamFromTemplate() provisioning pipeline.
+ *
+ * Ref: docs/onboarding-agent-framework-v1.1.md (Section 5 — Ingestion Format)
+ *
+ * @module services/onboarding/onboarding-provision.types
+ */
+// =============================================================================
+// Vertical → Template Mapping
+// =============================================================================
+/**
+ * Static mapping from vertical + goal to the best-match template ID.
+ *
+ * This is the core resolution logic: given a customer's vertical and goal,
+ * which template should we provision?
+ *
+ * Keys: `${vertical}::${goal}` — fallback to vertical-only if goal doesn't
+ * narrow the match.
+ */
+export const VERTICAL_TEMPLATE_MAP = {
+    // Content/Marketing
+    'Content/Marketing::Scale': 'growth-marketing-team',
+    'Content/Marketing::Time': 'ai-video-social-team',
+    // E-commerce/Sales
+    'E-commerce/Sales::Scale': 'growth-marketing-team',
+    'E-commerce/Sales::Time': 'customer-ops-team',
+    // Software/Tech
+    'Software/Tech::Scale': 'web-dev-team',
+    'Software/Tech::Time': 'web-dev-team',
+    // Insurance
+    'Insurance::Scale': 'broker-squad-v1',
+    'Insurance::Time': 'broker-squad-v1',
+    // Property Management
+    'Property Management::Scale': 'prop-manager-v1',
+    'Property Management::Time': 'prop-manager-v1',
+};
+/** Default fallback template when no mapping matches. */
+export const DEFAULT_TEMPLATE_ID = 'startup-team';
+/**
+ * Resolve the best template ID for a given vertical and goal.
+ *
+ * @param vertical - Customer's business vertical
+ * @param goal - Customer's primary goal (Scale or Time)
+ * @returns The matched template ID
+ */
+export function resolveTemplateId(vertical, goal) {
+    const key = `${vertical}::${goal}`;
+    return VERTICAL_TEMPLATE_MAP[key] ?? DEFAULT_TEMPLATE_ID;
+}
+// =============================================================================
+// Type Guards
+// =============================================================================
+const VALID_VERTICALS = new Set([
+    'Content/Marketing',
+    'E-commerce/Sales',
+    'Software/Tech',
+    'Insurance',
+    'Property Management',
+]);
+const VALID_GOALS = new Set(['Scale', 'Time']);
+const VALID_BUDGET_TIERS = new Set([
+    'starter',
+    'pro',
+    'managed',
+]);
+const VALID_URGENCY = new Set([
+    'immediate',
+    'this_week',
+    'this_month',
+    'exploring',
+]);
+const VALID_TEAM_SIZES = new Set([
+    'solo',
+    'small',
+    'medium',
+    'large',
+]);
+/**
+ * Validate whether a value is a valid OnboardingVertical.
+ *
+ * @param value - Value to check
+ * @returns True if value is a valid vertical
+ */
+export function isValidVertical(value) {
+    return typeof value === 'string' && VALID_VERTICALS.has(value);
+}
+/**
+ * Validate whether a value is a valid OnboardingGoal.
+ *
+ * @param value - Value to check
+ * @returns True if value is a valid goal
+ */
+export function isValidGoal(value) {
+    return typeof value === 'string' && VALID_GOALS.has(value);
+}
+/**
+ * Validate whether a value is a valid OnboardingBudgetTier.
+ *
+ * @param value - Value to check
+ * @returns True if value is a valid budget tier
+ */
+export function isValidBudgetTier(value) {
+    return typeof value === 'string' && VALID_BUDGET_TIERS.has(value);
+}
+/**
+ * Validate an OnboardingProvisionRequest payload.
+ * Checks required fields and enum validity.
+ *
+ * @param value - Value to validate
+ * @returns Object with `valid` flag and optional `errors` array
+ */
+export function validateProvisionRequest(value) {
+    const errors = [];
+    if (typeof value !== 'object' || value === null) {
+        return { valid: false, errors: ['Request body must be a non-null object'] };
+    }
+    const req = value;
+    // customer.identity
+    const customer = req['customer'];
+    if (!customer || typeof customer !== 'object') {
+        errors.push('customer is required and must be an object');
+    }
+    else {
+        const identity = customer['identity'];
+        if (!identity || typeof identity !== 'object') {
+            errors.push('customer.identity is required');
+        }
+        else {
+            if (!identity['name'] || typeof identity['name'] !== 'string') {
+                errors.push('customer.identity.name is required (string)');
+            }
+            if (!isValidVertical(identity['vertical'])) {
+                errors.push(`customer.identity.vertical must be one of: ${[...VALID_VERTICALS].join(', ')}`);
+            }
+            if (!VALID_TEAM_SIZES.has(identity['size'])) {
+                errors.push(`customer.identity.size must be one of: ${[...VALID_TEAM_SIZES].join(', ')}`);
+            }
+        }
+        // customer.strategy
+        const strategy = customer['strategy'];
+        if (!strategy || typeof strategy !== 'object') {
+            errors.push('customer.strategy is required');
+        }
+        else {
+            if (!isValidGoal(strategy['goal'])) {
+                errors.push(`customer.strategy.goal must be one of: ${[...VALID_GOALS].join(', ')}`);
+            }
+            if (!isValidBudgetTier(strategy['budget'])) {
+                errors.push(`customer.strategy.budget must be one of: ${[...VALID_BUDGET_TIERS].join(', ')}`);
+            }
+            if (!VALID_URGENCY.has(strategy['urgency'])) {
+                errors.push(`customer.strategy.urgency must be one of: ${[...VALID_URGENCY].join(', ')}`);
+            }
+        }
+    }
+    return { valid: errors.length === 0, errors };
+}
+//# sourceMappingURL=onboarding-provision.types.js.map

package/dist/backend/backend/src/services/onboarding/onboarding-provision.types.js.map

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

package/dist/backend/backend/src/services/onboarding/website-analysis.service.d.ts

@@ -0,0 +1,141 @@
+/**
+ * Website Analysis Service — Independent, Reusable Brand Extraction Pipeline
+ *
+ * Analyzes a website URL and produces a structured AnalysisDraft with per-field
+ * confidence scores and source provenance. Designed for KR3 "magic onboarding"
+ * but intentionally independent of the onboarding flow for reuse in template
+ * previews, competitor analysis, and brand profile updates.
+ *
+ * Pipeline (4 stages with streaming progress):
+ * 1. Fetch homepage — DNS/SSL/redirect handling, robots.txt respect
+ * 2. Discover pages — find about/services/products/team pages (same-domain)
+ * 3. Extract content — HTML-to-text, metadata extraction from all pages
+ * 4. Generate draft — LLM structured extraction with confidence + source
+ *
+ * @module services/onboarding/website-analysis.service
+ */
+import { WebsiteExtractorService } from './website-extractor.service.js';
+import type { AnalysisDraft, AnalysisOptions, AnalysisResult, TemplateRecommendation } from './website-analysis.types.js';
+/**
+ * WebsiteAnalysisService provides an independent, reusable pipeline for
+ * extracting structured brand data from a website URL.
+ *
+ * Uses WebsiteExtractorService for low-level fetching/parsing, then adds:
+ * - Structured AnalysisDraft output with per-field confidence + source
+ * - 4-stage streaming progress events
+ * - Template recommendation based on extracted profile
+ * - Partial results on failure (graceful degradation)
+ *
+ * @example
+ * ```typescript
+ * const service = WebsiteAnalysisService.getInstance();
+ * const result = await service.analyze({
+ *   url: 'https://example.com',
+ *   onProgress: (event) => console.log(event.stage, event.progress),
+ * });
+ * ```
+ */
+export declare class WebsiteAnalysisService {
+    private static instance;
+    private readonly logger;
+    private extractor;
+    private constructor();
+    /**
+     * Get the singleton instance.
+     *
+     * @returns WebsiteAnalysisService instance
+     */
+    static getInstance(): WebsiteAnalysisService;
+    /**
+     * Reset the singleton (for testing).
+     */
+    static resetInstance(): void;
+    /**
+     * Override the extractor (for testing).
+     *
+     * @param extractor - Custom WebsiteExtractorService instance
+     */
+    setExtractor(extractor: WebsiteExtractorService): void;
+    /**
+     * Analyze a website and produce a structured AnalysisDraft.
+     *
+     * Runs the 4-stage pipeline with streaming progress events.
+     * Returns partial results on failure (graceful degradation).
+     *
+     * @param options - Analysis options including URL and progress callback
+     * @returns Analysis result with draft, timing, and metadata
+     */
+    analyze(options: AnalysisOptions): Promise<AnalysisResult>;
+    /**
+     * Enrich the draft with data from page metadata (title, og tags, meta description).
+     * Used as fallback when LLM extraction is unavailable.
+     *
+     * @param draft - Draft to enrich
+     * @param pages - Processed pages with metadata
+     */
+    private enrichDraftFromMetadata;
+    /**
+     * Map LLM extraction result to AnalysisDraft fields with confidence + source.
+     *
+     * @param draft - Draft to populate
+     * @param result - Raw LLM extraction result
+     * @param pages - Source pages for provenance
+     */
+    private mapLlmResultToDraft;
+    /**
+     * Identify fields that were not extracted and add to missingFields.
+     *
+     * @param draft - Draft to check
+     */
+    private identifyMissingFields;
+    /**
+     * Recommend a template based on the extracted brand profile.
+     * Uses rule-based industry matching (can evolve to LLM-based later).
+     *
+     * @param draft - Current analysis draft
+     * @returns Template recommendation with confidence and reason
+     */
+    recommendTemplate(draft: AnalysisDraft): TemplateRecommendation;
+    /**
+     * Create a progress event for streaming UI updates.
+     *
+     * @param stage - Current pipeline stage
+     * @param message - Human-readable status message
+     * @param progress - Percentage complete (0-100)
+     * @param partialDraft - Optional partial draft
+     * @param error - Optional error message
+     * @returns Progress event
+     */
+    private createProgress;
+    /**
+     * Create an AnalysisField with full provenance.
+     *
+     * @param value - Extracted value
+     * @param confidence - Confidence level
+     * @param url - Source page URL
+     * @param snippet - Relevant source snippet
+     * @param pageTitle - Source page title
+     * @param method - Extraction method
+     * @returns Complete AnalysisField
+     */
+    private createField;
+    /**
+     * Normalize a URL: add protocol if missing, ensure trailing format.
+     *
+     * @param url - Raw URL input
+     * @returns Normalized URL with protocol
+     */
+    private normalizeUrl;
+    /**
+     * Build the final AnalysisResult object.
+     *
+     * @param success - Whether analysis completed successfully
+     * @param draft - The analysis draft
+     * @param startTime - Pipeline start timestamp
+     * @param pagesFetched - Number of pages fetched
+     * @param error - Optional error message
+     * @returns Complete analysis result
+     */
+    private buildResult;
+}
+//# sourceMappingURL=website-analysis.service.d.ts.map

package/dist/backend/backend/src/services/onboarding/website-analysis.service.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"website-analysis.service.d.ts","sourceRoot":"","sources":["../../../../../../backend/src/services/onboarding/website-analysis.service.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;AAGH,OAAO,EAAE,uBAAuB,EAAgD,MAAM,gCAAgC,CAAC;AACvH,OAAO,KAAK,EACV,aAAa,EAIb,eAAe,EACf,cAAc,EAGd,sBAAsB,EACvB,MAAM,6BAA6B,CAAC;AAkDrC;;;;;;;;;;;;;;;;;;GAkBG;AACH,qBAAa,sBAAsB;IACjC,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAuC;IAC9D,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAkB;IACzC,OAAO,CAAC,SAAS,CAA0B;IAE3C,OAAO;IAKP;;;;OAIG;IACH,MAAM,CAAC,WAAW,IAAI,sBAAsB;IAO5C;;OAEG;IACH,MAAM,CAAC,aAAa,IAAI,IAAI;IAI5B;;;;OAIG;IACH,YAAY,CAAC,SAAS,EAAE,uBAAuB,GAAG,IAAI;IAQtD;;;;;;;;OAQG;IACG,OAAO,CAAC,OAAO,EAAE,eAAe,GAAG,OAAO,CAAC,cAAc,CAAC;IA0HhE;;;;;;OAMG;IACH,OAAO,CAAC,uBAAuB;IAmD/B;;;;;;OAMG;IACH,OAAO,CAAC,mBAAmB;IAuC3B;;;;OAIG;IACH,OAAO,CAAC,qBAAqB;IAa7B;;;;;;OAMG;IACH,iBAAiB,CAAC,KAAK,EAAE,aAAa,GAAG,sBAAsB;IA2C/D;;;;;;;;;OASG;IACH,OAAO,CAAC,cAAc;IAUtB;;;;;;;;;;OAUG;IACH,OAAO,CAAC,WAAW;IAoBnB;;;;;OAKG;IACH,OAAO,CAAC,YAAY;IAQpB;;;;;;;;;OASG;IACH,OAAO,CAAC,WAAW;CAepB"}