labre-mcp 0.1.0

package/dist/work-on-evolution/strategies/solution/solution-evolution-result.d.mts

@@ -0,0 +1,361 @@
+/** Total number of Wardley evolution properties in the reference model. */
+export declare const PROPERTY_COUNT = 12;
+/** Default weight for each property (equal weighting: 1/N). */
+export declare const DEFAULT_WEIGHT: number;
+/**
+ * Canonical property identifiers, matching evolution-properties.json.
+ * Order follows the reference file.
+ */
+export declare const PROPERTY_IDS: readonly string[];
+/**
+ * Canonical property names (human-readable), matching evolution-properties.json.
+ */
+export declare const PROPERTY_NAMES: readonly string[];
+/**
+ * Map from property ID to canonical name.
+ * @type {ReadonlyMap<string, string>}
+ */
+export declare const PROPERTY_ID_TO_NAME: Readonly<Map<string, string>>;
+/**
+ * Map from canonical name (lowercase) to property ID.
+ * @type {ReadonlyMap<string, string>}
+ */
+export declare const PROPERTY_NAME_TO_ID: Readonly<Map<string, string>>;
+/**
+ * Individual property phase score within a solution evolution evaluation.
+ *
+ * Extends the base PropertyEvaluation typedef with:
+ *   - Property ID (canonical machine identifier)
+ *   - Per-property confidence score
+ *   - Phase description text from the reference
+ *   - Computed evolution value for this property
+ *
+ * @example
+ *   const score = PropertyScore.create('market', 'Market', 3, 'Growing competitive market');
+ *   score.evolution   // → 0.55 (Product midpoint)
+ *   score.label       // → 'Product'
+ *   score.confidence  // → null (not set)
+ */
+export declare class PropertyScore {
+    /**
+     * @param {Object} data
+     * @param {string}  data.id               - Canonical property ID (e.g. 'market')
+     * @param {string}  data.property         - Human-readable property name (e.g. 'Market')
+     * @param {number}  data.phase            - Evaluated phase (1–4)
+     * @param {string}  [data.label]          - Phase label (auto-derived if omitted)
+     * @param {number}  [data.weight]         - Weight (default: 1/12)
+     * @param {number}  [data.confidence]     - Per-property evaluation confidence (0–1), null if unknown
+     * @param {string}  [data.reason]         - Reasoning for the phase assignment
+     * @param {string}  [data.phaseDescription] - Phase description text from reference
+     */
+    id: string;
+    property: string;
+    phase: number;
+    label: string;
+    weight: number;
+    confidence: number | null;
+    reason: string | null;
+    phaseDescription: string | null;
+    constructor({ id, property, phase, label, weight, confidence, reason, phaseDescription }: {
+        id: string;
+        property: string;
+        phase: number;
+        label?: string;
+        weight?: number;
+        confidence?: number | null;
+        reason?: string | null;
+        phaseDescription?: string | null;
+    });
+    /**
+     * Computed evolution value for this property's phase.
+     * Uses the standard Wardley phase-to-evolution mapping.
+     *
+     * @returns {number} Evolution midpoint (0–1) for the assigned phase
+     */
+    get evolution(): number;
+    /**
+     * Factory method: create a PropertyScore with minimal required fields.
+     *
+     * @param {string} id       - Property ID (e.g. 'market')
+     * @param {string} property - Property name (e.g. 'Market')
+     * @param {number} phase    - Phase (1–4)
+     * @param {string} [reason] - Optional reason
+     * @param {Object} [extra]  - Optional extra fields (confidence, phaseDescription, weight)
+     * @returns {PropertyScore}
+     */
+    static create(id: string, property: string, phase: number, reason?: string, extra?: Partial<{
+        confidence: number | null;
+        phaseDescription: string | null;
+        weight: number;
+        label: string;
+    }>): PropertyScore;
+    /**
+     * Factory method: create from a PropertyEvaluation plain object
+     * (as returned by SolutionBaseStrategy.buildPropertyEvaluation).
+     *
+     * @param {Object} evalObj  - PropertyEvaluation-shaped object
+     * @param {string} [id]     - Property ID (derived from name if omitted)
+     * @returns {PropertyScore}
+     */
+    static fromPropertyEvaluation(evalObj: {
+        property: string;
+        phase: number;
+        label?: string;
+        weight?: number;
+        reason?: string;
+    }, id?: string): PropertyScore;
+    /**
+     * Convert to a plain PropertyEvaluation object
+     * (compatible with SolutionBaseStrategy.validateSolutionResult).
+     *
+     * @returns {{ property: string, phase: number, label: string, weight: number, reason?: string }}
+     */
+    toPropertyEvaluation(): any;
+    /**
+     * Full JSON representation including all fields.
+     * @returns {Object}
+     */
+    toJSON(): {
+        phaseDescription?: string | undefined;
+        reason?: string | undefined;
+        confidence?: number | undefined;
+        id: string;
+        property: string;
+        phase: number;
+        label: string;
+        weight: number;
+        evolution: number;
+    };
+}
+/**
+ * Structured metadata about how the overall confidence score was computed.
+ *
+ * Captures the evaluation context (mode, aggregation method) and
+ * per-property confidence statistics, enabling downstream consumers
+ * to understand and explain the confidence level.
+ *
+ * @example
+ *   const meta = new ConfidenceMetadata({
+ *     coverage: 1.0,
+ *     evaluatedCount: 12,
+ *     totalCount: 12,
+ *     mode: 'auto',
+ *   });
+ */
+export declare class ConfidenceMetadata {
+    /**
+     * @param {Object} data
+     * @param {number}  data.coverage               - Ratio of evaluated vs total properties (0–1)
+     * @param {number}  data.evaluatedCount          - Number of properties successfully evaluated
+     * @param {number}  [data.totalCount]            - Total properties in reference (default: 12)
+     * @param {string}  [data.mode]                  - Evaluation mode: 'auto' | 'conversational'
+     * @param {number}  [data.meanPropertyConfidence] - Mean confidence across per-property scores
+     * @param {string}  [data.aggregationMethod]     - How properties were aggregated
+     * @param {number}  [data.phaseAgreement]        - Inter-property phase consistency (0–1)
+     */
+    coverage: number;
+    evaluatedCount: number;
+    totalCount: number;
+    mode: string;
+    meanPropertyConfidence: number | null;
+    aggregationMethod: string;
+    phaseAgreement: number | null;
+    constructor({ coverage, evaluatedCount, totalCount, mode, meanPropertyConfidence, aggregationMethod, phaseAgreement, }: {
+        coverage: number;
+        evaluatedCount: number;
+        totalCount?: number;
+        mode?: string;
+        meanPropertyConfidence?: number | null;
+        aggregationMethod?: string;
+        phaseAgreement?: number | null;
+    });
+    /**
+     * JSON representation.
+     * @returns {Object}
+     */
+    toJSON(): {
+        phaseAgreement?: number | undefined;
+        meanPropertyConfidence?: number | undefined;
+        coverage: number;
+        evaluatedCount: number;
+        totalCount: number;
+        mode: string;
+        aggregationMethod: string;
+    };
+}
+/**
+ * Structured result type for solution evolution evaluation.
+ *
+ * Holds:
+ *   - Individual phase scores for each of the 12 Wardley evolution properties
+ *     (Market, Knowledge management, Market perception, etc.)
+ *   - Overall evolution placement on the 0–1 Wardley competitive axis
+ *   - Confidence metadata explaining how the confidence was computed
+ *   - Trace of evaluation steps
+ *
+ * Fully aligned with the EvolutionResult contract from BaseStrategy:
+ *   - toEvolutionResult() returns a plain { evolution, confidence, method, trace, properties }
+ *   - validate() checks both the core contract and solution-specific extensions
+ *   - Can be consumed anywhere the capability EvolutionResult is accepted
+ *
+ * @example
+ *   // Construction from property scores
+ *   const result = SolutionEvolutionResult.fromPropertyScores(scores, {
+ *     method: 'solution-properties',
+ *     mode: 'auto',
+ *   });
+ *
+ *   // Direct construction
+ *   const result = new SolutionEvolutionResult({
+ *     evolution: 0.55,
+ *     confidence: 0.85,
+ *     method: 'solution-properties',
+ *     properties: [...],
+ *   });
+ *
+ *   // Interop with capability pipeline
+ *   const plain = result.toEvolutionResult();
+ *   BaseStrategy.validateResult(plain); // passes
+ */
+export declare class SolutionEvolutionResult {
+    evolution: number;
+    confidence: number;
+    method: string;
+    trace: unknown[];
+    properties: Array<PropertyScore | {
+        property: string;
+        phase: number;
+        label?: string;
+        weight?: number;
+        reason?: string;
+    }>;
+    confidenceMetadata: ConfidenceMetadata | null;
+    constructor({ evolution, confidence, method, trace, properties, confidenceMetadata }: {
+        evolution: number;
+        confidence: number;
+        method: string;
+        trace?: unknown[];
+        properties?: Array<PropertyScore | {
+            property: string;
+            phase: number;
+            label?: string;
+            weight?: number;
+            reason?: string;
+        }>;
+        confidenceMetadata?: ConfidenceMetadata | null;
+    });
+    /**
+     * The Wardley stage label for the overall evolution position.
+     * @returns {string} 'Genesis' | 'Custom' | 'Product' | 'Commodity'
+     */
+    get stage(): "Genesis" | "Custom" | "Product" | "Commodity";
+    /**
+     * Number of per-property evaluations.
+     * @returns {number}
+     */
+    get propertyCount(): number;
+    /**
+     * Mean phase across all evaluated properties.
+     * @returns {number|null} Mean phase (1–4) or null if no properties
+     */
+    get meanPhase(): number | null;
+    /**
+     * Phase distribution: count of properties at each phase.
+     * @returns {{ 1: number, 2: number, 3: number, 4: number }}
+     */
+    get phaseDistribution(): {
+        1: number;
+        2: number;
+        3: number;
+        4: number;
+    };
+    /**
+     * Build a SolutionEvolutionResult from an array of PropertyScore instances.
+     *
+     * Computes:
+     *   - Weighted aggregation of property phases into overall evolution
+     *   - Coverage-based overall confidence
+     *   - Confidence metadata from per-property statistics
+     *
+     * @param {PropertyScore[]} scores   - Array of property evaluations
+     * @param {Object} options
+     * @param {string}  options.method   - Strategy identifier
+     * @param {string}  [options.mode]   - Evaluation mode ('auto' | 'conversational')
+     * @param {Array}   [options.trace]  - Additional trace entries
+     * @returns {SolutionEvolutionResult}
+     */
+    static fromPropertyScores(scores: PropertyScore[], { method, mode, trace }: {
+        method: string;
+        mode?: string;
+        trace?: unknown[];
+    }): SolutionEvolutionResult;
+    /**
+     * Reconstruct a SolutionEvolutionResult from a plain EvolutionResult object
+     * (as returned by toEvolutionResult() or existing strategy evaluate() methods).
+     *
+     * Useful for upgrading legacy results to the structured model.
+     *
+     * @param {Object} plainResult - Plain { evolution, confidence, method, trace?, properties? }
+     * @returns {SolutionEvolutionResult}
+     */
+    static fromEvolutionResult(plainResult: {
+        evolution: number;
+        confidence: number;
+        method: string;
+        trace?: unknown[];
+        properties?: unknown[];
+        confidenceMetadata?: unknown;
+    }): SolutionEvolutionResult;
+    /**
+     * Validate this result against both the core EvolutionResult contract
+     * and solution-specific extensions.
+     *
+     * @returns {SolutionEvolutionResult} this (for chaining)
+     * @throws {TypeError} If any field violates the contract
+     */
+    validate(): this;
+    /**
+     * Convert to a plain EvolutionResult object, fully compatible with
+     * the capability strategy pipeline (BaseStrategy.validateResult).
+     *
+     * This is the canonical way to pass solution results through any
+     * consumer that expects the standard EvolutionResult shape.
+     *
+     * @returns {{ evolution: number, confidence: number, method: string, trace: Array, properties: Array }}
+     */
+    toEvolutionResult(): {
+        evolution: number;
+        confidence: number;
+        method: string;
+        trace: unknown[];
+        properties: any[];
+    };
+    /**
+     * Full JSON representation with all structured fields.
+     * Includes confidence metadata and rich property details.
+     *
+     * @returns {Object}
+     */
+    toJSON(): {
+        confidenceMetadata?: any;
+        evolution: number;
+        confidence: number;
+        method: string;
+        stage: string;
+        meanPhase: number | null;
+        phaseDistribution: {
+            1: number;
+            2: number;
+            3: number;
+            4: number;
+        };
+        trace: unknown[];
+        properties: any[];
+    };
+    /**
+     * Human-readable summary string.
+     * @returns {string}
+     */
+    toString(): string;
+}
+//# sourceMappingURL=solution-evolution-result.d.mts.map

package/dist/work-on-evolution/strategies/solution/solution-evolution-result.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"solution-evolution-result.d.mts","sourceRoot":"","sources":["../../../../src/work-on-evolution/strategies/solution/solution-evolution-result.mts"],"names":[],"mappings":"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"}