@nahisaho/musubix-lean 1.8.5

package/dist/converters/EarsToLeanConverter.d.ts

@@ -0,0 +1,61 @@
+/**
+ * @fileoverview EARS to Lean converter
+ * @module @nahisaho/musubix-lean/converters
+ * @traceability REQ-LEAN-CONV-001 to REQ-LEAN-CONV-005
+ */
+import { type Result } from 'neverthrow';
+import type { EarsRequirement, EarsPattern, EarsParsedComponents, LeanTheorem } from '../types.js';
+import { EarsConversionError, EarsParseError } from '../errors.js';
+/**
+ * Parse EARS requirement text into components
+ * @traceability REQ-LEAN-CONV-001
+ */
+export declare function parseEarsRequirement(text: string): Result<EarsParsedComponents, EarsParseError>;
+/**
+ * Build Lean theorem from EARS components
+ * @traceability REQ-LEAN-CONV-001
+ */
+export declare function buildLeanTheorem(components: EarsParsedComponents, requirementId: string, sourceText: string): LeanTheorem;
+/**
+ * Convert EARS requirement to Lean theorem
+ * @traceability REQ-LEAN-CONV-001
+ */
+export declare function convertEarsToLean(requirement: EarsRequirement): Result<LeanTheorem, EarsConversionError>;
+/**
+ * Convert raw EARS text to Lean theorem
+ */
+export declare function convertEarsTextToLean(id: string, text: string): Result<LeanTheorem, EarsParseError | EarsConversionError>;
+/**
+ * Detect EARS pattern from text
+ */
+export declare function detectEarsPattern(text: string): EarsPattern | null;
+/**
+ * EarsToLeanConverter class implementation
+ * @traceability REQ-LEAN-CONV-001
+ */
+export declare class EarsToLeanConverter {
+    /**
+     * Convert EARS requirement to Lean theorem
+     */
+    convert(requirement: EarsRequirement): Result<LeanTheorem, EarsConversionError>;
+    /**
+     * Parse EARS text into components
+     */
+    parseEars(text: string): Result<EarsParsedComponents, EarsParseError>;
+    /**
+     * Build theorem from parsed components
+     */
+    buildTheorem(components: EarsParsedComponents, reqId: string, sourceText?: string): LeanTheorem;
+    /**
+     * Batch convert multiple requirements
+     * @traceability REQ-LEAN-ERR-002
+     */
+    convertBatch(requirements: EarsRequirement[]): {
+        successes: LeanTheorem[];
+        failures: {
+            id: string;
+            error: string;
+        }[];
+    };
+}
+//# sourceMappingURL=EarsToLeanConverter.d.ts.map

package/dist/converters/EarsToLeanConverter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"EarsToLeanConverter.d.ts","sourceRoot":"","sources":["../../src/converters/EarsToLeanConverter.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAW,KAAK,MAAM,EAAE,MAAM,YAAY,CAAC;AAClD,OAAO,KAAK,EACV,eAAe,EACf,WAAW,EACX,oBAAoB,EACpB,WAAW,EAGZ,MAAM,aAAa,CAAC;AACrB,OAAO,EAAE,mBAAmB,EAAE,cAAc,EAAE,MAAM,cAAc,CAAC;AAanE;;;GAGG;AACH,wBAAgB,oBAAoB,CAClC,IAAI,EAAE,MAAM,GACX,MAAM,CAAC,oBAAoB,EAAE,cAAc,CAAC,CAmE9C;AAuBD;;;GAGG;AACH,wBAAgB,gBAAgB,CAC9B,UAAU,EAAE,oBAAoB,EAChC,aAAa,EAAE,MAAM,EACrB,UAAU,EAAE,MAAM,GACjB,WAAW,CAwHb;AAED;;;GAGG;AACH,wBAAgB,iBAAiB,CAC/B,WAAW,EAAE,eAAe,GAC3B,MAAM,CAAC,WAAW,EAAE,mBAAmB,CAAC,CAwB1C;AAED;;GAEG;AACH,wBAAgB,qBAAqB,CACnC,EAAE,EAAE,MAAM,EACV,IAAI,EAAE,MAAM,GACX,MAAM,CAAC,WAAW,EAAE,cAAc,GAAG,mBAAmB,CAAC,CAc3D;AAED;;GAEG;AACH,wBAAgB,iBAAiB,CAAC,IAAI,EAAE,MAAM,GAAG,WAAW,GAAG,IAAI,CAGlE;AAED;;;GAGG;AACH,qBAAa,mBAAmB;IAC9B;;OAEG;IACH,OAAO,CAAC,WAAW,EAAE,eAAe,GAAG,MAAM,CAAC,WAAW,EAAE,mBAAmB,CAAC;IAI/E;;OAEG;IACH,SAAS,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAAC,oBAAoB,EAAE,cAAc,CAAC;IAIrE;;OAEG;IACH,YAAY,CACV,UAAU,EAAE,oBAAoB,EAChC,KAAK,EAAE,MAAM,EACb,UAAU,GAAE,MAAW,GACtB,WAAW;IAId;;;OAGG;IACH,YAAY,CACV,YAAY,EAAE,eAAe,EAAE,GAC9B;QAAE,SAAS,EAAE,WAAW,EAAE,CAAC;QAAC,QAAQ,EAAE;YAAE,EAAE,EAAE,MAAM,CAAC;YAAC,KAAK,EAAE,MAAM,CAAA;SAAE,EAAE,CAAA;KAAE;CAkB3E"}

package/dist/converters/EarsToLeanConverter.js

@@ -0,0 +1,300 @@
+/**
+ * @fileoverview EARS to Lean converter
+ * @module @nahisaho/musubix-lean/converters
+ * @traceability REQ-LEAN-CONV-001 to REQ-LEAN-CONV-005
+ */
+import { ok, err } from 'neverthrow';
+import { EarsConversionError, EarsParseError } from '../errors.js';
+/**
+ * EARS pattern regex definitions
+ */
+const EARS_PATTERNS = {
+    ubiquitous: /^THE\s+(.+?)\s+SHALL\s+(.+)$/i,
+    eventDriven: /^WHEN\s+(.+?),?\s+THE\s+(.+?)\s+SHALL\s+(.+)$/i,
+    stateDriven: /^WHILE\s+(.+?),?\s+THE\s+(.+?)\s+SHALL\s+(.+)$/i,
+    unwanted: /^THE\s+(.+?)\s+SHALL\s+NOT\s+(.+)$/i,
+    optional: /^IF\s+(.+?),?\s+THEN\s+THE\s+(.+?)\s+SHALL\s+(.+)$/i,
+};
+/**
+ * Parse EARS requirement text into components
+ * @traceability REQ-LEAN-CONV-001
+ */
+export function parseEarsRequirement(text) {
+    const trimmedText = text.trim();
+    // Try Unwanted pattern first (SHALL NOT before SHALL)
+    const unwantedMatch = trimmedText.match(EARS_PATTERNS.unwanted);
+    if (unwantedMatch) {
+        return ok({
+            pattern: 'unwanted',
+            subject: unwantedMatch[1].trim(),
+            action: unwantedMatch[2].trim(),
+            negated: true,
+        });
+    }
+    // Try Event-driven pattern
+    const eventMatch = trimmedText.match(EARS_PATTERNS.eventDriven);
+    if (eventMatch) {
+        return ok({
+            pattern: 'event-driven',
+            trigger: eventMatch[1].trim(),
+            subject: eventMatch[2].trim(),
+            action: eventMatch[3].trim(),
+            negated: false,
+        });
+    }
+    // Try State-driven pattern
+    const stateMatch = trimmedText.match(EARS_PATTERNS.stateDriven);
+    if (stateMatch) {
+        return ok({
+            pattern: 'state-driven',
+            state: stateMatch[1].trim(),
+            subject: stateMatch[2].trim(),
+            action: stateMatch[3].trim(),
+            negated: false,
+        });
+    }
+    // Try Optional pattern
+    const optionalMatch = trimmedText.match(EARS_PATTERNS.optional);
+    if (optionalMatch) {
+        return ok({
+            pattern: 'optional',
+            condition: optionalMatch[1].trim(),
+            subject: optionalMatch[2].trim(),
+            action: optionalMatch[3].trim(),
+            negated: false,
+        });
+    }
+    // Try Ubiquitous pattern
+    const ubiquitousMatch = trimmedText.match(EARS_PATTERNS.ubiquitous);
+    if (ubiquitousMatch) {
+        return ok({
+            pattern: 'ubiquitous',
+            subject: ubiquitousMatch[1].trim(),
+            action: ubiquitousMatch[2].trim(),
+            negated: false,
+        });
+    }
+    return err(new EarsParseError(text, 'Text does not match any EARS pattern (Ubiquitous, Event-driven, State-driven, Unwanted, or Optional)'));
+}
+/**
+ * Convert natural language to Lean identifier
+ */
+function toLeanIdentifier(text) {
+    return text
+        .toLowerCase()
+        .replace(/[^a-z0-9\s]/g, '')
+        .split(/\s+/)
+        .filter((s) => s.length > 0)
+        .map((s, i) => (i === 0 ? s : s.charAt(0).toUpperCase() + s.slice(1)))
+        .join('');
+}
+/**
+ * Convert natural language to Lean predicate name
+ */
+function toLeanPredicateName(text) {
+    const base = toLeanIdentifier(text);
+    return base.charAt(0).toUpperCase() + base.slice(1);
+}
+/**
+ * Build Lean theorem from EARS components
+ * @traceability REQ-LEAN-CONV-001
+ */
+export function buildLeanTheorem(components, requirementId, sourceText) {
+    const theoremName = `req_${requirementId.replace(/[^a-zA-Z0-9]/g, '_').toLowerCase()}`;
+    const hypotheses = [];
+    let conclusion;
+    let leanCode;
+    const subjectPred = toLeanPredicateName(components.subject);
+    const actionPred = toLeanPredicateName(components.action);
+    switch (components.pattern) {
+        case 'ubiquitous':
+            // THE [system] SHALL [requirement]
+            // ∀ x, System x → Action x
+            conclusion = {
+                type: `∀ x, ${subjectPred} x → ${actionPred} x`,
+                leanCode: `∀ x, ${subjectPred} x → ${actionPred} x`,
+            };
+            leanCode = `
+/-- ${sourceText}
+    @requirement ${requirementId}
+-/
+theorem ${theoremName} : ∀ x, ${subjectPred} x → ${actionPred} x := by
+  intro x h_system
+  sorry -- TODO: Complete proof
+`;
+            break;
+        case 'event-driven':
+            // WHEN [event], THE [system] SHALL [response]
+            // event → response
+            hypotheses.push({
+                name: 'h_event',
+                type: toLeanPredicateName(components.trigger || ''),
+                leanCode: `h_event : ${toLeanPredicateName(components.trigger || '')}`,
+            });
+            conclusion = {
+                type: actionPred,
+                leanCode: actionPred,
+            };
+            leanCode = `
+/-- ${sourceText}
+    @requirement ${requirementId}
+-/
+theorem ${theoremName} (h_event : ${toLeanPredicateName(components.trigger || '')}) : ${actionPred} := by
+  sorry -- TODO: Complete proof
+`;
+            break;
+        case 'state-driven':
+            // WHILE [state], THE [system] SHALL [response]
+            // state → invariant_preserved
+            hypotheses.push({
+                name: 'h_state',
+                type: toLeanPredicateName(components.state || ''),
+                leanCode: `h_state : ${toLeanPredicateName(components.state || '')}`,
+            });
+            conclusion = {
+                type: `${actionPred} ∧ ${toLeanPredicateName(components.state || '')}`,
+                leanCode: `${actionPred} ∧ ${toLeanPredicateName(components.state || '')}`,
+            };
+            leanCode = `
+/-- ${sourceText}
+    @requirement ${requirementId}
+-/
+theorem ${theoremName} (h_state : ${toLeanPredicateName(components.state || '')}) : ${actionPred} ∧ ${toLeanPredicateName(components.state || '')} := by
+  constructor
+  · sorry -- TODO: Prove action
+  · exact h_state
+`;
+            break;
+        case 'unwanted':
+            // THE [system] SHALL NOT [behavior]
+            // ¬ unwanted_behavior
+            conclusion = {
+                type: `¬ ${actionPred}`,
+                leanCode: `¬ ${actionPred}`,
+            };
+            leanCode = `
+/-- ${sourceText}
+    @requirement ${requirementId}
+-/
+theorem ${theoremName} : ¬ ${actionPred} := by
+  intro h_unwanted
+  sorry -- TODO: Derive contradiction
+`;
+            break;
+        case 'optional':
+            // IF [condition], THEN THE [system] SHALL [response]
+            // condition → response
+            hypotheses.push({
+                name: 'h_cond',
+                type: toLeanPredicateName(components.condition || ''),
+                leanCode: `h_cond : ${toLeanPredicateName(components.condition || '')}`,
+            });
+            conclusion = {
+                type: actionPred,
+                leanCode: actionPred,
+            };
+            leanCode = `
+/-- ${sourceText}
+    @requirement ${requirementId}
+-/
+theorem ${theoremName} (h_cond : ${toLeanPredicateName(components.condition || '')}) : ${actionPred} := by
+  sorry -- TODO: Complete proof
+`;
+            break;
+    }
+    return {
+        id: requirementId,
+        name: theoremName,
+        statement: conclusion.leanCode,
+        requirementId,
+        hypotheses,
+        conclusion,
+        sourceText,
+        leanCode,
+    };
+}
+/**
+ * Convert EARS requirement to Lean theorem
+ * @traceability REQ-LEAN-CONV-001
+ */
+export function convertEarsToLean(requirement) {
+    try {
+        if (!requirement.parsed) {
+            return err(new EarsConversionError(requirement.id, 'Requirement has no parsed components'));
+        }
+        const theorem = buildLeanTheorem(requirement.parsed, requirement.id, requirement.text);
+        return ok(theorem);
+    }
+    catch (error) {
+        return err(new EarsConversionError(requirement.id, error instanceof Error ? error.message : String(error)));
+    }
+}
+/**
+ * Convert raw EARS text to Lean theorem
+ */
+export function convertEarsTextToLean(id, text) {
+    const parseResult = parseEarsRequirement(text);
+    if (parseResult.isErr()) {
+        return err(parseResult.error);
+    }
+    const requirement = {
+        id,
+        pattern: parseResult.value.pattern,
+        text,
+        parsed: parseResult.value,
+    };
+    return convertEarsToLean(requirement);
+}
+/**
+ * Detect EARS pattern from text
+ */
+export function detectEarsPattern(text) {
+    const result = parseEarsRequirement(text);
+    return result.isOk() ? result.value.pattern : null;
+}
+/**
+ * EarsToLeanConverter class implementation
+ * @traceability REQ-LEAN-CONV-001
+ */
+export class EarsToLeanConverter {
+    /**
+     * Convert EARS requirement to Lean theorem
+     */
+    convert(requirement) {
+        return convertEarsToLean(requirement);
+    }
+    /**
+     * Parse EARS text into components
+     */
+    parseEars(text) {
+        return parseEarsRequirement(text);
+    }
+    /**
+     * Build theorem from parsed components
+     */
+    buildTheorem(components, reqId, sourceText = '') {
+        return buildLeanTheorem(components, reqId, sourceText);
+    }
+    /**
+     * Batch convert multiple requirements
+     * @traceability REQ-LEAN-ERR-002
+     */
+    convertBatch(requirements) {
+        const successes = [];
+        const failures = [];
+        for (const req of requirements) {
+            const result = this.convert(req);
+            if (result.isOk()) {
+                successes.push(result.value);
+            }
+            else {
+                failures.push({
+                    id: req.id,
+                    error: result.error.message,
+                });
+            }
+        }
+        return { successes, failures };
+    }
+}
+//# sourceMappingURL=EarsToLeanConverter.js.map

package/dist/converters/EarsToLeanConverter.js.map

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

package/dist/converters/TypeScriptSpecifier.d.ts

@@ -0,0 +1,63 @@
+/**
+ * @fileoverview TypeScript to Lean specification converter
+ * @module @nahisaho/musubix-lean/converters
+ * @traceability REQ-LEAN-TS-001 to REQ-LEAN-TS-004
+ */
+import { type Result } from 'neverthrow';
+import type { TypeScriptFunction, TypeScriptParameter, LeanFunctionSpec, Precondition, Postcondition, Invariant } from '../types.js';
+import { TypeScriptSpecificationError } from '../errors.js';
+/**
+ * Convert TypeScript type to Lean type
+ * @traceability REQ-LEAN-TS-001
+ */
+export declare function convertTypeToLean(tsType: string): string;
+/**
+ * Build Lean function specification from TypeScript function
+ * @traceability REQ-LEAN-TS-001
+ */
+export declare function buildFunctionSpec(func: TypeScriptFunction): Result<LeanFunctionSpec, TypeScriptSpecificationError>;
+/**
+ * Extract preconditions from JSDoc comments
+ * @traceability REQ-LEAN-TS-002
+ */
+export declare function extractPreconditionsFromJSDoc(jsdoc: string): Precondition[];
+/**
+ * Extract postconditions from JSDoc comments
+ * @traceability REQ-LEAN-TS-003
+ */
+export declare function extractPostconditionsFromJSDoc(jsdoc: string): Postcondition[];
+/**
+ * Extract invariants from JSDoc comments
+ * @traceability REQ-LEAN-TS-004
+ */
+export declare function extractInvariantsFromJSDoc(jsdoc: string): Invariant[];
+/**
+ * TypeScriptSpecifier class implementation
+ * @traceability REQ-LEAN-TS-001
+ */
+export declare class TypeScriptSpecifier {
+    /**
+     * Specify a TypeScript function as Lean specification
+     */
+    specify(func: TypeScriptFunction): Result<LeanFunctionSpec, TypeScriptSpecificationError>;
+    /**
+     * Extract function signature info (simplified)
+     */
+    extractSignature(_code: string, _funcName: string): {
+        params: TypeScriptParameter[];
+        returnType: string;
+    };
+    /**
+     * Infer preconditions from function body
+     */
+    inferPreconditions(_func: TypeScriptFunction): Precondition[];
+    /**
+     * Infer postconditions from function body
+     */
+    inferPostconditions(_func: TypeScriptFunction): Postcondition[];
+    /**
+     * Convert type to Lean
+     */
+    convertType(tsType: string): string;
+}
+//# sourceMappingURL=TypeScriptSpecifier.d.ts.map

package/dist/converters/TypeScriptSpecifier.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"TypeScriptSpecifier.d.ts","sourceRoot":"","sources":["../../src/converters/TypeScriptSpecifier.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAW,KAAK,MAAM,EAAE,MAAM,YAAY,CAAC;AAClD,OAAO,KAAK,EACV,kBAAkB,EAClB,mBAAmB,EACnB,gBAAgB,EAGhB,YAAY,EACZ,aAAa,EACb,SAAS,EACV,MAAM,aAAa,CAAC;AACrB,OAAO,EAAE,4BAA4B,EAAE,MAAM,cAAc,CAAC;AAqB5D;;;GAGG;AACH,wBAAgB,iBAAiB,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,CAkExD;AAuED;;;GAGG;AACH,wBAAgB,iBAAiB,CAC/B,IAAI,EAAE,kBAAkB,GACvB,MAAM,CAAC,gBAAgB,EAAE,4BAA4B,CAAC,CA+CxD;AAED;;;GAGG;AACH,wBAAgB,6BAA6B,CAAC,KAAK,EAAE,MAAM,GAAG,YAAY,EAAE,CAyB3E;AAED;;;GAGG;AACH,wBAAgB,8BAA8B,CAAC,KAAK,EAAE,MAAM,GAAG,aAAa,EAAE,CAwB7E;AAED;;;GAGG;AACH,wBAAgB,0BAA0B,CAAC,KAAK,EAAE,MAAM,GAAG,SAAS,EAAE,CAsBrE;AAED;;;GAGG;AACH,qBAAa,mBAAmB;IAC9B;;OAEG;IACH,OAAO,CACL,IAAI,EAAE,kBAAkB,GACvB,MAAM,CAAC,gBAAgB,EAAE,4BAA4B,CAAC;IAIzD;;OAEG;IACH,gBAAgB,CACd,KAAK,EAAE,MAAM,EACb,SAAS,EAAE,MAAM,GAChB;QAAE,MAAM,EAAE,mBAAmB,EAAE,CAAC;QAAC,UAAU,EAAE,MAAM,CAAA;KAAE;IAKxD;;OAEG;IACH,kBAAkB,CAAC,KAAK,EAAE,kBAAkB,GAAG,YAAY,EAAE;IAK7D;;OAEG;IACH,mBAAmB,CAAC,KAAK,EAAE,kBAAkB,GAAG,aAAa,EAAE;IAK/D;;OAEG;IACH,WAAW,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM;CAGpC"}