labre-mcp 0.1.0

package/dist/work-on-evolution/s-curve/s-curve.mjs

@@ -0,0 +1,93 @@
+// S-curve model: (certitude, ubiquity) → { zone, evolution }
+// Based on Wardley's evolution model with binary zone classification
+//
+// The band is defined by two independent generalized sigmoids:
+//   upper boundary: rises earlier, gentler slope
+//   lower boundary: rises later, steeper slope
+// Inside the band = competitive market (classic Wardley evolution)
+// Outside the band = still projected geometrically (zone is informational, confidence degrades)
+// This naturally creates three visual stages:
+//   Foot (thin) → Belly (thick) → Top (medium)
+//
+// Each boundary: f(c) = yMin + (yMax - yMin) * sigmoid(c, k, x0)^nu
+//   yMin/yMax — asymptotic range (instead of fixed 0→1)
+//   nu — skew: 1=standard, >1=stays low longer, <1=rises early
+// Calibratable parameters — two independent generalized sigmoids
+export const DEFAULT_PARAMS = {
+    kUpper: 8.5, x0Upper: 0.28, yMinUpper: 0, yMaxUpper: 1, nuUpper: 2.1,
+    kLower: 7, x0Lower: 0.54, yMinLower: 0, yMaxLower: 0.98, nuLower: 1.7,
+};
+// Raw sigmoid (0→1)
+export function sigmoid(c, k, x0) {
+    return 1 / (1 + Math.exp(-k * (c - x0)));
+}
+// Generalized sigmoid with range and skew
+function gsigmoid(c, k, x0, yMin, yMax, nu) {
+    return yMin + (yMax - yMin) * Math.pow(sigmoid(c, k, x0), nu);
+}
+export function bandUpper(c, params = DEFAULT_PARAMS) {
+    return gsigmoid(c, params.kUpper, params.x0Upper, params.yMinUpper, params.yMaxUpper, params.nuUpper);
+}
+export function bandLower(c, params = DEFAULT_PARAMS) {
+    return gsigmoid(c, params.kLower, params.x0Lower, params.yMinLower, params.yMaxLower, params.nuLower);
+}
+// Center of the band — used for geometric projection
+export function centerCurve(c, params = DEFAULT_PARAMS) {
+    return (bandUpper(c, params) + bandLower(c, params)) / 2;
+}
+// Is the point inside the evolution band?
+export function isInBand(c, u, params = DEFAULT_PARAMS) {
+    return u >= bandLower(c, params) && u <= bandUpper(c, params);
+}
+// Classify zone: competitive (inside band) / extra-competitive-market (outside band)
+export function classifyZone(c, u, params = DEFAULT_PARAMS) {
+    return isInBand(c, u, params) ? 'competitive' : 'extra-competitive-market';
+}
+// Signed distance from band boundary: positive = inside, negative = outside
+export function bandDistance(c, u, params = DEFAULT_PARAMS) {
+    const upper = bandUpper(c, params);
+    const lower = bandLower(c, params);
+    if (u > upper)
+        return -(u - upper);
+    if (u < lower)
+        return -(lower - u);
+    return Math.min(u - lower, upper - u);
+}
+// Geometric projection onto the center curve → { evolution: t* ∈ [0, 1], distToCenter }
+export function projectOnCurve(c, u, params = DEFAULT_PARAMS) {
+    let bestT = 0;
+    let bestDist = Infinity;
+    for (let t = 0; t <= 1; t += 0.001) {
+        const pu = centerCurve(t, params);
+        const dist = (t - c) ** 2 + (pu - u) ** 2;
+        if (dist < bestDist) {
+            bestDist = dist;
+            bestT = t;
+        }
+    }
+    return {
+        evolution: Math.round(bestT * 1000) / 1000,
+        distToCenter: Math.round(Math.sqrt(bestDist) * 1000) / 1000,
+    };
+}
+// Main function: (certitude, ubiquity) → { zone, evolution, phase, bandDistance }
+// any: returns a heterogeneous result bag (zone, evolution, phase, bandDistance, distToCenter)
+export function computeEvolution(certitude, ubiquity, params = DEFAULT_PARAMS) {
+    const zone = classifyZone(certitude, ubiquity, params);
+    const bd = bandDistance(certitude, ubiquity, params);
+    // Always project geometrically onto center curve — evolution is always in [0, 1].
+    // distToCenter = Euclidean distance from point to nearest point on center sigmoid.
+    const proj = projectOnCurve(certitude, ubiquity, params);
+    const phase = proj.evolution <= 0.18 ? 'Genesis' :
+        proj.evolution <= 0.40 ? 'Custom' :
+            proj.evolution <= 0.70 ? 'Product' :
+                'Commodity';
+    return {
+        zone,
+        evolution: proj.evolution,
+        phase,
+        bandDistance: Math.round(bd * 1000) / 1000,
+        distToCenter: proj.distToCenter,
+    };
+}
+//# sourceMappingURL=s-curve.mjs.map

package/dist/work-on-evolution/s-curve/s-curve.mjs.map

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

package/dist/work-on-evolution/skill-handler.d.mts

@@ -0,0 +1,99 @@
+import { evolutionToStage, formatConfidence, strategyReasoning } from '../lib/response-formatter.mjs';
+import { routeEstimateEvolution, detectMode, MODES } from '../work-on-evolution/routing/mode-router.mjs';
+/**
+ * Parse a conversational input string into structured parameters.
+ *
+ * Supports multiple input formats:
+ *   1. Structured key-value: "Component: ERP, Context: enterprise software, Space: economic"
+ *   2. Bullet/dash list: "- Component: ERP\n- Description: enterprise software"
+ *   3. Natural language: "Estimate evolution for ERP in the enterprise software space"
+ *   4. Minimal: "ERP" (just a component name)
+ *
+ * @param {string} input - Raw conversational text
+ * @returns {Object} Parsed parameters ready for estimateEvolutionOneShot()
+ */
+export declare function parseConversationalInput(input: any): any;
+/**
+ * Handle a conversational skill invocation.
+ *
+ * This is the main entry point called by the Claude Code skill system.
+ * It parses the conversational input, invokes estimateEvolutionOneShot(),
+ * and returns a formatted result suitable for display in conversation.
+ *
+ * @param {string} conversationalInput - Raw user text that triggered the skill
+ * @returns {Promise<Object>} Result from estimateEvolutionOneShot with conversational metadata
+ */
+export declare function handleSkillInvocation(conversationalInput: any): Promise<any>;
+/**
+ * Format an evaluation result for human-readable conversational output.
+ *
+ * Delegates to the response-formatter module for rich output including:
+ * - Evolution stage names (Genesis / Custom-Built / Product / Commodity)
+ * - Confidence bars and descriptive labels
+ * - Per-strategy reasoning explanations
+ * - Consensus overview for multi-strategy evaluations
+ * - Re-questioning guidance for non-economic components
+ *
+ * @param {Object} result - Result from handleSkillInvocation()
+ * @param {Object} [options] - Formatting options
+ * @param {boolean} [options.compact] - Use compact table format instead of detailed
+ * @returns {string} Markdown-formatted conversational output
+ */
+export declare function formatConversationalResult(result: any, options?: any): any;
+export { evolutionToStage, formatConfidence, strategyReasoning };
+export { routeEstimateEvolution, detectMode, MODES };
+/**
+ * Handle a skill invocation with automatic mode selection.
+ *
+ * This is the recommended entry point for Claude Code skill triggers.
+ * It parses conversational input, detects the optimal mode (one-shot or guided),
+ * and routes through the unified mode router for consistent response formatting.
+ *
+ * Mode selection:
+ *   - Explicit mode in input (e.g., "mode: guided") → uses that mode
+ *   - sessionState present → guided (continuing conversation)
+ *   - Sufficient numeric params → one-shot (direct evaluation)
+ *   - Minimal input → guided (progressive gathering)
+ *
+ * @param {string|Object} input - Conversational text or structured input object
+ * @param {Object} [options] - Additional options
+ * @param {string} [options.mode] - Override mode ('oneshot' | 'guided' | 'auto')
+ * @param {string} [options.sessionState] - Session state for guided continuation
+ * @param {boolean} [options.forceEstimate] - Force estimation with partial data
+ * @returns {Promise<Object>} Routed result with formatted output, mode info, and strategies
+ */
+export declare function handleSkillWithModeRouting(input: any, options?: any): Promise<any>;
+/**
+ * Handle a multi-turn conversational skill invocation.
+ *
+ * This manages the progressive question-asking flow:
+ *   Turn 1: User provides initial input -> session created, first question returned
+ *   Turn N: User answers question -> data merged, next question or final result returned
+ *
+ * Each call returns a structured response with:
+ *   - The current phase and next question to ask (if not ready)
+ *   - A formatted markdown response for the user
+ *   - The serialized session state to pass back on the next turn
+ *   - The final evaluation results when enough context is gathered
+ *
+ * @param {Object} input
+ * @param {string}  [input.userMessage]   - Raw user text from the current turn
+ * @param {string}  [input.sessionState]  - Serialized session from previous turn (null for first turn)
+ * @param {boolean} [input.forceEstimate] - Force estimation with partial data
+ * @param {string}  [input.strategy]      - Strategy override (default: 'all')
+ * @returns {Promise<Object>} Conversational response with phase, question, sessionState, and formatted output
+ */
+export declare function handleConversationalInvocation(input?: any): Promise<any>;
+/**
+ * Format a conversational turn into a human-readable markdown response.
+ *
+ * Handles three cases:
+ *   1. Intermediate turn: presents the next question with hints and progress
+ *   2. Non-economic result: presents re-questioning prompts
+ *   3. Final estimation: presents the strategy results and consensus
+ *
+ * @param {Object} result - Result from estimateEvolutionConversational()
+ * @returns {string} Markdown-formatted response for this turn
+ */
+export declare function formatConversationalTurn(result: any): string;
+//# sourceMappingURL=skill-handler.d.mts.map

package/dist/work-on-evolution/skill-handler.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"skill-handler.d.mts","sourceRoot":"","sources":["../../src/work-on-evolution/skill-handler.mts"],"names":[],"mappings":"AAeA,OAAO,EAAkB,gBAAgB,EAAE,gBAAgB,EAAE,iBAAiB,EAAE,MAAM,+BAA+B,CAAC;AACtH,OAAO,EAAE,sBAAsB,EAAE,UAAU,EAAE,KAAK,EAAE,MAAM,8CAA8C,CAAC;AA8CzG;;;;;;;;;;;GAWG;AAEH,wBAAgB,wBAAwB,CAAC,KAAK,EAAE,GAAG,GAAG,GAAG,CAgBxD;AA8ND;;;;;;;;;GASG;AAEH,wBAAsB,qBAAqB,CAAC,mBAAmB,EAAE,GAAG,GAAG,OAAO,CAAC,GAAG,CAAC,CAalF;AAED;;;;;;;;;;;;;;GAcG;AAEH,wBAAgB,0BAA0B,CAAC,MAAM,EAAE,GAAG,EAAE,OAAO,GAAE,GAAQ,GAAG,GAAG,CAK9E;AAGD,OAAO,EAAE,gBAAgB,EAAE,gBAAgB,EAAE,iBAAiB,EAAE,CAAC;AAGjE,OAAO,EAAE,sBAAsB,EAAE,UAAU,EAAE,KAAK,EAAE,CAAC;AAIrD;;;;;;;;;;;;;;;;;;;GAmBG;AAEH,wBAAsB,0BAA0B,CAAC,KAAK,EAAE,GAAG,EAAE,OAAO,GAAE,GAAQ,GAAG,OAAO,CAAC,GAAG,CAAC,CA+B5F;AAID;;;;;;;;;;;;;;;;;;;GAmBG;AAEH,wBAAsB,8BAA8B,CAAC,KAAK,GAAE,GAAQ,GAAG,OAAO,CAAC,GAAG,CAAC,CA+BlF;AAED;;;;;;;;;;GAUG;AAEH,wBAAgB,wBAAwB,CAAC,MAAM,EAAE,GAAG,GAAG,MAAM,CA6J5D"}