labre-mcp 0.1.0

package/dist/work-on-value-chain/generate-value-chain.mjs

@@ -0,0 +1,257 @@
+// Generate a Wardley Map .wm file from a business description.
+//
+// Pipeline:
+//   1. LLM decomposes the business context into a value chain
+//   2. Each component is evaluated via estimateEvolution (MCP tool)
+//   3. A .wm file is generated with correct OWM syntax
+//
+// Usage:
+//   import { generateValueChain } from './generate-value-chain.mjs';
+//   const result = await generateValueChain('A tea shop serving customers');
+import { z } from 'zod';
+import { GenerateValueChainInputSchema } from '../schemas/generate-value-chain.schema.mjs';
+import { writeFile, mkdir } from 'node:fs/promises';
+import { join, dirname } from 'node:path';
+import { createLLMCall } from '../lib/llm/llm-call.mjs';
+import { estimateEvolutionOneShot } from '../work-on-evolution/estimate-evolution.mjs';
+import { logDebug, logInfo, logError } from '../lib/mcp-notifications.mjs';
+import { createMessageResolverFromArgs } from '../lib/progress-messages.mjs';
+import { toErrorMessage } from '../lib/errors.mjs';
+// ─── Value Chain Decomposition Prompt ───────────────────────────────────────
+const DECOMPOSE_PROMPT = `You are an expert Wardley Mapper.
+
+Given a business description, decompose it into a value chain for a Wardley Map.
+
+Business description: {{description}}
+
+REASONING STEPS:
+1. Identify the primary user need (this becomes the anchor)
+2. Identify all components needed to satisfy that need
+3. For each component, determine its visibility (how visible it is to the user):
+   - 0.95: directly visible to the user (anchor level)
+   - 0.70-0.90: user-facing components
+   - 0.40-0.70: enabling components (middleware, platforms)
+   - 0.10-0.40: infrastructure components (compute, storage, networking)
+4. Determine dependencies: which components depend on which
+5. Give each component a short context description for evolution evaluation
+
+Return a JSON object with this exact structure:
+{
+  "title": "Map title",
+  "anchor": { "name": "User Need Name", "context": "brief context" },
+  "components": [
+    {
+      "name": "Component Name",
+      "context": "brief context for evolution evaluation",
+      "visibility": 0.75,
+      "dependsOn": ["Other Component Name"]
+    }
+  ]
+}
+
+IMPORTANT:
+- Component names must be unique
+- Visibility must be between 0.05 and 0.95
+- dependsOn references must match exact component names
+- The anchor is NOT listed in components
+- Include 5-15 components for a meaningful map
+- Return ONLY the JSON, no markdown fences or extra text`;
+// ─── .wm File Generation ────────────────────────────────────────────────────
+/**
+ * Generate OWM .wm content from a decomposed value chain with evaluated positions.
+ *
+ * @param {Object} chain - Decomposed value chain
+ * @param {Object<string, number>} evolutions - Component name → evolution score
+ * @returns {string} Valid .wm file content
+ */
+function generateWmContent(chain, evolutions) {
+    const lines = [];
+    // Title
+    lines.push(`title ${chain.title}`);
+    lines.push('');
+    // Anchor — high visibility, maturity from evaluation or default
+    const anchorEvo = evolutions[chain.anchor.name] ?? 0.5;
+    lines.push(`anchor ${chain.anchor.name} [0.95, ${anchorEvo.toFixed(2)}]`);
+    lines.push('');
+    // Components sorted by visibility (highest first)
+    const sorted = [...chain.components].sort((a, b) => b.visibility - a.visibility);
+    for (const comp of sorted) {
+        const evo = evolutions[comp.name] ?? 0.5;
+        lines.push(`component ${comp.name} [${comp.visibility.toFixed(2)}, ${evo.toFixed(2)}]`);
+    }
+    lines.push('');
+    // Links — anchor to top-level components
+    const topLevel = chain.components.filter((c) => c.visibility >= 0.70);
+    for (const comp of topLevel) {
+        lines.push(`${chain.anchor.name}->${comp.name}`);
+    }
+    // Links — component dependencies
+    for (const comp of chain.components) {
+        if (comp.dependsOn) {
+            for (const dep of comp.dependsOn) {
+                lines.push(`${comp.name}->${dep}`);
+            }
+        }
+    }
+    lines.push('');
+    lines.push('style wardley');
+    return lines.join('\n');
+}
+// ─── Filename Generation ────────────────────────────────────────────────────
+function slugify(text) {
+    return text
+        .toLowerCase()
+        .replace(/[^a-z0-9]+/g, '-')
+        .replace(/^-|-$/g, '')
+        .slice(0, 50);
+}
+// ─── Main Function ──────────────────────────────────────────────────────────
+/**
+ * Generate a complete Wardley Map .wm file from a business description.
+ *
+ * @param {string} description - Business description
+ * @param {Object} [options={}]
+ * @param {string} [options.filename] - Output filename (without extension)
+ * @param {string} [options.outputDir='maps/myMaps'] - Output directory
+ * @param {string} [options.strategy='timeline-benchmark'] - Evolution evaluation strategy
+ * @returns {Promise<{wmContent: string, filePath: string, components: Array, evaluations: Object}>}
+ */
+// any: result includes wmContent, filePath, components, evaluations, lang — heterogeneous
+export async function generateValueChain(description, options = {}) {
+    const { filename, outputDir = 'maps/myMaps', strategy = 'timeline-benchmark', } = options;
+    const TOOL = 'generateValueChain';
+    // ── Localized message resolver ──────────────────────────────────────
+    const { msg, lang } = createMessageResolverFromArgs({ description });
+    // Info-level: tool start (localized)
+    logInfo(TOOL, msg('tool.start.valuechain', { tool: TOOL }));
+    const t0 = Date.now();
+    logDebug(TOOL, `Parameters: strategy="${strategy}", outputDir="${outputDir}", lang=${lang}`);
+    // Step 1: Decompose value chain via LLM
+    logDebug(TOOL, msg('step.decomposition'));
+    const llmCall = createLLMCall({ model: 'claude-sonnet-4-6', effort: 'high' });
+    const rawResponse = await llmCall(DECOMPOSE_PROMPT, { description });
+    // Parse JSON — strip markdown fences if present
+    const jsonStr = rawResponse.replace(/```json?\n?/g, '').replace(/```/g, '').trim();
+    let chain;
+    try {
+        chain = JSON.parse(jsonStr);
+    }
+    catch (err) {
+        logError(TOOL, msg('error.generic', { tool: TOOL, error: `Failed to parse LLM response: ${toErrorMessage(err)}` }));
+        throw new Error(`Failed to parse LLM value chain response: ${toErrorMessage(err)}\nRaw: ${rawResponse.slice(0, 500)}`);
+    }
+    // Validate chain structure
+    if (!chain.title || !chain.anchor || !chain.components?.length) {
+        logError(TOOL, msg('error.generic', { tool: TOOL, error: 'LLM returned invalid value chain structure' }));
+        throw new Error('LLM returned invalid value chain structure');
+    }
+    logDebug(TOOL, `Decomposition complete: "${chain.title}" — ${chain.components.length} components + 1 anchor`);
+    // Step 2: Evaluate evolution for each component + anchor
+    const evaluations = {};
+    const allItems = [
+        { name: chain.anchor.name, context: chain.anchor.context },
+        ...chain.components.map((c) => ({ name: c.name, context: c.context })),
+    ];
+    for (let i = 0; i < allItems.length; i++) {
+        const item = allItems[i];
+        // Debug: per-component progress
+        logDebug(TOOL, msg('step.evaluation.progress', {
+            current: i + 1,
+            total: allItems.length,
+            component: item.name,
+        }));
+        try {
+            const result = await estimateEvolutionOneShot({
+                name: item.name,
+                description: item.context || description,
+                strategy,
+            });
+            if (result.evaluations) {
+                // Pick the requested strategy's result, or first successful one
+                const stratResult = result.evaluations[strategy]
+                    || // any: evaluations values are heterogeneous strategy results
+                        Object.values(result.evaluations).find(e => !e.error);
+                if (stratResult && !stratResult.error) {
+                    evaluations[item.name] = Math.max(0, Math.min(1, stratResult.evolution));
+                    logDebug(TOOL, msg('step.evaluation.bestpick', {
+                        component: item.name,
+                        evolution: evaluations[item.name],
+                        strategy: strategy,
+                        confidence: stratResult.confidence ?? 'N/A',
+                    }));
+                }
+            }
+        }
+        catch (err) {
+            // Log but skip failed evaluations — will use default 0.5
+            logDebug(TOOL, msg('step.evaluation.skipped', {
+                component: item.name,
+                reason: toErrorMessage(err) || 'evaluation failed',
+            }));
+        }
+    }
+    logDebug(TOOL, msg('step.evaluation.summary', {
+        evaluated: Object.keys(evaluations).length,
+        skipped: allItems.length - Object.keys(evaluations).length,
+        total: allItems.length,
+    }));
+    // Step 3: Generate .wm content
+    logDebug(TOOL, msg('step.wm.generation', { count: chain.components.length }));
+    const wmContent = generateWmContent(chain, evaluations);
+    // Step 4: Write file
+    const finalFilename = filename || slugify(chain.title);
+    const filePath = join(outputDir, `${finalFilename}.wm`);
+    await mkdir(dirname(filePath), { recursive: true });
+    await writeFile(filePath, wmContent, 'utf-8');
+    // Info-level: tool end (localized)
+    const duration = Date.now() - t0;
+    logInfo(TOOL, msg('tool.end.valuechain', { tool: TOOL, count: chain.components.length, duration }));
+    return {
+        wmContent,
+        filePath,
+        components: chain.components,
+        evaluations,
+    };
+}
+// ─── MCP Tool Definition ────────────────────────────────────────────────────
+export const GENERATE_VALUE_CHAIN_TOOL = {
+    name: 'generateValueChain',
+    description: 'Generate a Wardley Map .wm file from a business description. ' +
+        'Decomposes the business into a value chain, evaluates component evolution, ' +
+        'and produces a valid .wm file for the VSCode Online Wardley Maps extension.',
+    inputSchema: z.toJSONSchema(GenerateValueChainInputSchema, { io: 'input' }),
+};
+/**
+ * MCP tool handler for generateValueChain.
+ * @param {Object} args - Tool arguments
+ * @returns {Promise<Object>} Result with wmContent, filePath, evaluations
+ */
+export async function handleGenerateValueChain(args) {
+    const input = GenerateValueChainInputSchema.parse(args);
+    return generateValueChain(input.description, {
+        filename: input.filename,
+        outputDir: input.outputDir,
+        strategy: input.strategy,
+    });
+}
+// ─── Self-test ──────────────────────────────────────────────────────────────
+if (process.argv[1] && import.meta.url === `file:///${process.argv[1].replace(/\\/g, '/')}`) {
+    console.log('=== generateValueChain self-test ===\n');
+    try {
+        const result = await generateValueChain('A tea shop serving hot beverages to customers', {
+            outputDir: 'maps/myMaps',
+        });
+        console.log('--- Generated .wm ---');
+        console.log(result.wmContent);
+        console.log(`\n--- File written to: ${result.filePath} ---`);
+        console.log(`--- Components: ${result.components.length} ---`);
+        console.log(`--- Evaluations: ${Object.keys(result.evaluations).length} ---`);
+        for (const [name, evo] of Object.entries(result.evaluations)) {
+            console.log(`  ${name}: ${evo}`);
+        }
+    }
+    catch (err) {
+        console.error('Self-test failed:', toErrorMessage(err));
+    }
+}
+//# sourceMappingURL=generate-value-chain.mjs.map

package/dist/work-on-value-chain/generate-value-chain.mjs.map

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

package/dist/work-on-value-chain/identify-capability.d.mts

@@ -0,0 +1,28 @@
+import type { McpToolDefinition } from '../types/mcp.mjs';
+import type { ParsedCapabilityResponse } from '../schemas/parsed-llm.schema.mjs';
+/**
+ * Parse LLM capability identification response.
+ * Input type (from OWM DSL) always takes priority over LLM-estimated type.
+ * @param {string} text - Raw LLM response
+ * @param {{ name: string, type?: string, context?: string }} component - Input component
+ * @returns {{ type: string, nature: string, capability: string, confidence: number, justification: string, context: string, name: string }}
+ */
+export declare function parseCapabilityResponse(text: string, component: any): ParsedCapabilityResponse;
+/**
+ * Identify the true underlying capability or need behind a component label.
+ *
+ * When type is provided (from OWM DSL):
+ *   - anchor/market/ecosystem → skip immediately, no LLM call
+ *   - component/pipeline → LLM identifies nature/capability, input type is authoritative
+ *
+ * When type is absent:
+ *   - LLM estimates type + nature + capability (no penalty)
+ *
+ * @param {{ name: string, type?: string, description?: string, context?: string }} component
+ * @param {function(string): Promise<string>} llmCall
+ * @returns {Promise<{ type: string, nature: string, capability: string, confidence: number, justification: string }>}
+ */
+export declare function identifyCapability(component: any, llmCall?: any): Promise<any>;
+export declare const IDENTIFY_CAPABILITY_TOOL: McpToolDefinition;
+export declare function handleIdentifyCapability(args: Record<string, unknown>): Promise<unknown>;
+//# sourceMappingURL=identify-capability.d.mts.map

package/dist/work-on-value-chain/identify-capability.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"identify-capability.d.mts","sourceRoot":"","sources":["../../src/work-on-value-chain/identify-capability.mts"],"names":[],"mappings":"AAUA,OAAO,KAAK,EAAE,iBAAiB,EAAc,MAAM,kBAAkB,CAAC;AAEtE,OAAO,KAAK,EAAE,wBAAwB,EAAE,MAAM,kCAAkC,CAAC;AAUjF;;;;;;GAMG;AAEH,wBAAgB,uBAAuB,CAAC,IAAI,EAAE,MAAM,EAAE,SAAS,EAAE,GAAG,GAAG,wBAAwB,CAqB9F;AAED;;;;;;;;;;;;;GAaG;AAEH,wBAAsB,kBAAkB,CAAC,SAAS,EAAE,GAAG,EAAE,OAAO,CAAC,EAAE,GAAG,GAAG,OAAO,CAAC,GAAG,CAAC,CAkCpF;AAID,eAAO,MAAM,wBAAwB,EAAE,iBAQtC,CAAC;AAEF,wBAAsB,wBAAwB,CAAC,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,OAAO,CAAC,OAAO,CAAC,CAoB9F"}

package/dist/work-on-value-chain/identify-capability.mjs

@@ -0,0 +1,118 @@
+// Identify the true underlying capability or need behind a component label.
+//
+// Reusable module: can be called by any strategy or tool that needs to
+// decode technical solution names (CRM, ERP, Kubernetes…) into the
+// capability they serve, classified by type and nature.
+//
+// Also exposes an MCP tool definition (IDENTIFY_CAPABILITY_TOOL) and
+// handler (handleIdentifyCapability) for direct invocation via MCP clients.
+import { z } from 'zod';
+import { IdentifyCapabilityInputSchema } from '../schemas/identify-capability.schema.mjs';
+import { getStrategyLLM } from '../lib/llm/registry.mjs';
+import { parseKeyValueBlock } from '../lib/prompts/parsers.mjs';
+import { getPrompt } from '../lib/prompts/registry.mjs';
+const ELIGIBLE_TYPES = new Set(['component', 'pipeline']);
+// Prompt text lives in prompts/identify-capability.md. Resolved via getPrompt().
+/**
+ * Parse LLM capability identification response.
+ * Input type (from OWM DSL) always takes priority over LLM-estimated type.
+ * @param {string} text - Raw LLM response
+ * @param {{ name: string, type?: string, context?: string }} component - Input component
+ * @returns {{ type: string, nature: string, capability: string, confidence: number, justification: string, context: string, name: string }}
+ */
+// any: component is the loose MCP input (name/type/description/context)
+export function parseCapabilityResponse(text, component) {
+    const raw = parseKeyValueBlock(text, ['type', 'nature', 'capability', 'confidence', 'justification']);
+    if (raw.capability === undefined) {
+        throw new Error(`identifyCapability: could not parse LLM response: ${text.slice(0, 200)}`);
+    }
+    // Original regex for `type` and `nature` captured \S+ (first token).
+    // parseKeyValueBlock captures the full line; reduce to the first token to preserve semantics.
+    const firstToken = (s) => s?.split(/\s+/)[0];
+    const llmType = firstToken(raw.type)?.toLowerCase() ?? 'component';
+    return {
+        type: component.type || llmType,
+        nature: firstToken(raw.nature)?.toLowerCase() ?? 'none',
+        capability: raw.capability,
+        context: component.context || '',
+        name: component.name || '',
+        confidence: raw.confidence !== undefined ? parseFloat(raw.confidence) : 0.5,
+        justification: raw.justification ?? '',
+    };
+}
+/**
+ * Identify the true underlying capability or need behind a component label.
+ *
+ * When type is provided (from OWM DSL):
+ *   - anchor/market/ecosystem → skip immediately, no LLM call
+ *   - component/pipeline → LLM identifies nature/capability, input type is authoritative
+ *
+ * When type is absent:
+ *   - LLM estimates type + nature + capability (no penalty)
+ *
+ * @param {{ name: string, type?: string, description?: string, context?: string }} component
+ * @param {function(string): Promise<string>} llmCall
+ * @returns {Promise<{ type: string, nature: string, capability: string, confidence: number, justification: string }>}
+ */
+// any: component is the loose MCP input; llmCall is a closure with diverse signatures
+export async function identifyCapability(component, llmCall) {
+    // When type is known and non-eligible, skip immediately
+    if (component.type && !ELIGIBLE_TYPES.has(component.type)) {
+        return {
+            type: component.type,
+            nature: 'none',
+            capability: component.name || '',
+            context: component.context || '',
+            name: component.name || '',
+            confidence: 1,
+            justification: `Type "${component.type}" is not eligible for capability identification (only component and pipeline are)`,
+            skipped: true,
+        };
+    }
+    const p = getPrompt('identify-capability');
+    const response = await llmCall(p.build({
+        component: component.name || '',
+        description: component.description ?? '',
+        context: component.context ?? '',
+    }));
+    const result = p.parse(response, component);
+    // When type was not provided, check if LLM-estimated type is non-eligible
+    if (!component.type && !ELIGIBLE_TYPES.has(result.type)) {
+        return {
+            ...result,
+            nature: 'none',
+            capability: component.name || '',
+            skipped: true,
+        };
+    }
+    return result;
+}
+// ─── MCP Tool Definition ───────────────────────────────────────────────────
+export const IDENTIFY_CAPABILITY_TOOL = {
+    name: 'identifyCapability',
+    description: 'Identify the true underlying capability or need behind a Wardley Map component label. ' +
+        'Decodes technical solution names (CRM, ERP, Kubernetes...) into the capability they serve, ' +
+        'classified by nature (activity, practice, knowledge, data). ' +
+        'Only works for component and pipeline types — other types (anchor, market, ecosystem) are returned as-is.',
+    inputSchema: z.toJSONSchema(IdentifyCapabilityInputSchema, { io: 'input' }),
+};
+export async function handleIdentifyCapability(args) {
+    const parsed = IdentifyCapabilityInputSchema.parse(args);
+    // Map parsed input onto the legacy local `args` name for minimal downstream diff
+    args = parsed;
+    if (!args?.name || typeof args.name !== 'string' || args.name.trim().length === 0) {
+        throw new Error('Required parameter "name" must be a non-empty string');
+    }
+    const name = args.name;
+    const type = args.type;
+    const description = args.description;
+    const context = args.context;
+    const component = {
+        name: name.trim(),
+        ...(type && { type }),
+        ...(description && { description: description.trim() }),
+        ...(context && { context: context.trim() }),
+    };
+    return identifyCapability(component, getStrategyLLM('identify-capability'));
+}
+//# sourceMappingURL=identify-capability.mjs.map

package/dist/work-on-value-chain/identify-capability.mjs.map

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

package/dist/work-on-value-chain/read/anchor/base-strategy.d.mts

@@ -0,0 +1,22 @@
+export type AnchorReadInput = any;
+export type AnchorRefinement = any;
+export declare class BaseAnchorReadStrategy {
+    /**
+     * Strategy identifier in "read:anchor:<strategy>" form.
+     * Must be overridden by each subclass.
+     */
+    static get method(): string;
+    /**
+     * Disabled flag. Return falsy to enable (default), or `{ reason: string }`
+     * to disable.
+     */
+    static get disabled(): boolean | {
+        reason: string;
+    };
+    /**
+     * Refine / correct / validate an anchor that is already provided in input.
+     * Must be overridden by every strategy.
+     */
+    refine(input: AnchorReadInput): AnchorRefinement | Promise<AnchorRefinement>;
+}
+//# sourceMappingURL=base-strategy.d.mts.map

package/dist/work-on-value-chain/read/anchor/base-strategy.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"base-strategy.d.mts","sourceRoot":"","sources":["../../../../src/work-on-value-chain/read/anchor/base-strategy.mts"],"names":[],"mappings":"AAcA,MAAM,MAAM,eAAe,GAAG,GAAG,CAAC;AAGlC,MAAM,MAAM,gBAAgB,GAAG,GAAG,CAAC;AAEnC,qBAAa,sBAAsB;IACjC;;;OAGG;IACH,MAAM,KAAK,MAAM,IAAI,MAAM,CAE1B;IAED;;;OAGG;IACH,MAAM,KAAK,QAAQ,IAAI,OAAO,GAAG;QAAE,MAAM,EAAE,MAAM,CAAA;KAAE,CAAkB;IAErE;;;OAGG;IACH,MAAM,CAAC,KAAK,EAAE,eAAe,GAAG,gBAAgB,GAAG,OAAO,CAAC,gBAAgB,CAAC;CAG7E"}

package/dist/work-on-value-chain/read/anchor/base-strategy.mjs

@@ -0,0 +1,34 @@
+// Base strategy for refining a value-chain anchor that is ALREADY provided in
+// the input — correcting, raffining or validating an existing anchor
+// description rather than inventing one from scratch.
+//
+// Namespace: read:anchor:<strategy>
+//
+// Read strategies differ from write strategies in that the target parameter
+// (the anchor) is supplied as input. The strategy produces a corrected /
+// refined / validated variant.
+//
+// No concrete read-anchor strategies exist yet — this base + registry is a
+// slot for future additions.
+export class BaseAnchorReadStrategy {
+    /**
+     * Strategy identifier in "read:anchor:<strategy>" form.
+     * Must be overridden by each subclass.
+     */
+    static get method() {
+        throw new Error('BaseAnchorReadStrategy.method must be overridden by subclass');
+    }
+    /**
+     * Disabled flag. Return falsy to enable (default), or `{ reason: string }`
+     * to disable.
+     */
+    static get disabled() { return false; }
+    /**
+     * Refine / correct / validate an anchor that is already provided in input.
+     * Must be overridden by every strategy.
+     */
+    refine(input) {
+        throw new Error(`${this.constructor.name}.refine() must be implemented`);
+    }
+}
+//# sourceMappingURL=base-strategy.mjs.map

package/dist/work-on-value-chain/read/anchor/base-strategy.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"base-strategy.mjs","sourceRoot":"","sources":["../../../../src/work-on-value-chain/read/anchor/base-strategy.mts"],"names":[],"mappings":"AAAA,8EAA8E;AAC9E,qEAAqE;AACrE,sDAAsD;AACtD,EAAE;AACF,oCAAoC;AACpC,EAAE;AACF,4EAA4E;AAC5E,yEAAyE;AACzE,+BAA+B;AAC/B,EAAE;AACF,2EAA2E;AAC3E,6BAA6B;AAQ7B,MAAM,OAAO,sBAAsB;IACjC;;;OAGG;IACH,MAAM,KAAK,MAAM;QACf,MAAM,IAAI,KAAK,CAAC,8DAA8D,CAAC,CAAC;IAClF,CAAC;IAED;;;OAGG;IACH,MAAM,KAAK,QAAQ,KAAmC,OAAO,KAAK,CAAC,CAAC,CAAC;IAErE;;;OAGG;IACH,MAAM,CAAC,KAAsB;QAC3B,MAAM,IAAI,KAAK,CAAC,GAAG,IAAI,CAAC,WAAW,CAAC,IAAI,+BAA+B,CAAC,CAAC;IAC3E,CAAC;CACF"}

package/dist/work-on-value-chain/read/anchor/registry.d.mts

@@ -0,0 +1,17 @@
+import { BaseAnchorReadStrategy } from './base-strategy.mjs';
+export type StrategyCtor = (new (...args: any[]) => BaseAnchorReadStrategy) & {
+    method: string;
+    disabled?: boolean | {
+        reason: string;
+    };
+};
+export declare function loadStrategies(): Promise<Map<string, StrategyCtor>>;
+export declare function listDisabled(): Promise<Array<{
+    method: string;
+    reason: string;
+}>>;
+export declare function isDisabled(method: string): Promise<boolean>;
+export declare function getStrategy(method: string): Promise<StrategyCtor>;
+export declare function listStrategies(): Promise<string[]>;
+export declare function clearCache(): void;
+//# sourceMappingURL=registry.d.mts.map

package/dist/work-on-value-chain/read/anchor/registry.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"registry.d.mts","sourceRoot":"","sources":["../../../../src/work-on-value-chain/read/anchor/registry.mts"],"names":[],"mappings":"AASA,OAAO,EAAE,sBAAsB,EAAE,MAAM,qBAAqB,CAAC;AAK7D,MAAM,MAAM,YAAY,GAAG,CAAC,KAAK,GAAG,IAAI,EAAE,GAAG,EAAE,KAAK,sBAAsB,CAAC,GAAG;IAC5E,MAAM,EAAE,MAAM,CAAC;IACf,QAAQ,CAAC,EAAE,OAAO,GAAG;QAAE,MAAM,EAAE,MAAM,CAAA;KAAE,CAAC;CACzC,CAAC;AAKF,wBAAsB,cAAc,IAAI,OAAO,CAAC,GAAG,CAAC,MAAM,EAAE,YAAY,CAAC,CAAC,CAoDzE;AAED,wBAAsB,YAAY,IAAI,OAAO,CAAC,KAAK,CAAC;IAAE,MAAM,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,MAAM,CAAA;CAAE,CAAC,CAAC,CAGvF;AAED,wBAAsB,UAAU,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAGjE;AAED,wBAAsB,WAAW,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,YAAY,CAAC,CAYvE;AAED,wBAAsB,cAAc,IAAI,OAAO,CAAC,MAAM,EAAE,CAAC,CAGxD;AAED,wBAAgB,UAAU,IAAI,IAAI,CAGjC"}

package/dist/work-on-value-chain/read/anchor/registry.mjs

@@ -0,0 +1,83 @@
+// Strategy registry for read:anchor:* strategies.
+//
+// Auto-discovers all *-strategy.{mjs,mts} files in this directory that export
+// a class extending BaseAnchorReadStrategy. Pattern mirrors
+// src/work-on-evolution/write/strategies/capacity/registry.mts.
+import { readdir } from 'node:fs/promises';
+import { fileURLToPath, pathToFileURL } from 'node:url';
+import { dirname, join } from 'node:path';
+import { BaseAnchorReadStrategy } from './base-strategy.mjs';
+const __filename = fileURLToPath(import.meta.url);
+const __dirname = dirname(__filename);
+let _cache = null;
+let _disabledCache = null;
+export async function loadStrategies() {
+    if (_cache)
+        return _cache;
+    const entries = await readdir(__dirname);
+    const strategyFiles = entries.filter(f => (f.endsWith('-strategy.mjs') || f.endsWith('-strategy.mts')) &&
+        f !== 'base-strategy.mjs' &&
+        f !== 'base-strategy.mts');
+    const strategies = new Map();
+    for (const file of strategyFiles) {
+        const fullPath = join(__dirname, file);
+        const mod = await import(pathToFileURL(fullPath).href);
+        for (const exportName of Object.keys(mod)) {
+            const candidate = mod[exportName];
+            if (typeof candidate === 'function' &&
+                candidate.prototype instanceof BaseAnchorReadStrategy &&
+                candidate !== BaseAnchorReadStrategy) {
+                const Cls = candidate;
+                const method = Cls.method;
+                if (strategies.has(method)) {
+                    throw new Error(`Duplicate strategy method "${method}" in ${file} — already registered`);
+                }
+                strategies.set(method, Cls);
+            }
+        }
+    }
+    const disabled = new Map();
+    for (const [method, Cls] of [...strategies]) {
+        const flag = Cls.disabled;
+        if (flag) {
+            const reason = flag && typeof flag === 'object' && typeof flag.reason === 'string'
+                ? flag.reason
+                : 'disabled';
+            disabled.set(method, { reason });
+            strategies.delete(method);
+        }
+    }
+    _cache = strategies;
+    _disabledCache = disabled;
+    return strategies;
+}
+export async function listDisabled() {
+    await loadStrategies();
+    return [..._disabledCache.entries()].map(([method, { reason }]) => ({ method, reason }));
+}
+export async function isDisabled(method) {
+    await loadStrategies();
+    return _disabledCache.has(method);
+}
+export async function getStrategy(method) {
+    const strategies = await loadStrategies();
+    const Cls = strategies.get(method);
+    if (!Cls) {
+        if (_disabledCache && _disabledCache.has(method)) {
+            const { reason } = _disabledCache.get(method);
+            throw new Error(`Strategy "${method}" is disabled: ${reason}`);
+        }
+        const available = [...strategies.keys()].join(', ') || '(none registered)';
+        throw new Error(`Unknown strategy "${method}". Available: ${available}`);
+    }
+    return Cls;
+}
+export async function listStrategies() {
+    const strategies = await loadStrategies();
+    return [...strategies.keys()];
+}
+export function clearCache() {
+    _cache = null;
+    _disabledCache = null;
+}
+//# sourceMappingURL=registry.mjs.map

package/dist/work-on-value-chain/read/anchor/registry.mjs.map

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

package/dist/work-on-value-chain/read/chain/base-strategy.d.mts

@@ -0,0 +1,22 @@
+export type ChainReadInput = any;
+export type ChainRefinement = any;
+export declare class BaseChainReadStrategy {
+    /**
+     * Strategy identifier in "read:chain:<strategy>" form.
+     * Must be overridden by each subclass.
+     */
+    static get method(): string;
+    /**
+     * Disabled flag. Return falsy to enable (default), or `{ reason: string }`
+     * to disable.
+     */
+    static get disabled(): boolean | {
+        reason: string;
+    };
+    /**
+     * Refine / correct / validate a value chain that is already provided in input.
+     * Must be overridden by every strategy.
+     */
+    refine(input: ChainReadInput): ChainRefinement | Promise<ChainRefinement>;
+}
+//# sourceMappingURL=base-strategy.d.mts.map

package/dist/work-on-value-chain/read/chain/base-strategy.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"base-strategy.d.mts","sourceRoot":"","sources":["../../../../src/work-on-value-chain/read/chain/base-strategy.mts"],"names":[],"mappings":"AAcA,MAAM,MAAM,cAAc,GAAG,GAAG,CAAC;AAGjC,MAAM,MAAM,eAAe,GAAG,GAAG,CAAC;AAElC,qBAAa,qBAAqB;IAChC;;;OAGG;IACH,MAAM,KAAK,MAAM,IAAI,MAAM,CAE1B;IAED;;;OAGG;IACH,MAAM,KAAK,QAAQ,IAAI,OAAO,GAAG;QAAE,MAAM,EAAE,MAAM,CAAA;KAAE,CAAkB;IAErE;;;OAGG;IACH,MAAM,CAAC,KAAK,EAAE,cAAc,GAAG,eAAe,GAAG,OAAO,CAAC,eAAe,CAAC;CAG1E"}