@mcp-graph-workflow/mcp-graph 5.5.3 → 5.6.1

package/dist/core/siebel/sif-generator.d.ts

@@ -0,0 +1,26 @@
+/**
+ * SIF Generator — two-phase SIF generation pipeline.
+ *
+ * Phase 1 (prepare): Assembles RAG context + prompt for the LLM.
+ * Phase 2 (finalize): Validates LLM output, indexes into knowledge store.
+ *
+ * The module does NOT call any LLM — it stays pure and testable.
+ */
+import { KnowledgeStore } from "../store/knowledge-store.js";
+import { type SifGenerationContext } from "./sif-context-assembler.js";
+import type { SifGenerationRequest, SifGenerationResult } from "../../schemas/siebel.schema.js";
+/**
+ * Phase 1: Prepare SIF generation context.
+ *
+ * Returns a structured context with prompt, templates, existing objects,
+ * and validation rules for the LLM to use.
+ */
+export declare function prepareSifGeneration(knowledgeStore: KnowledgeStore, request: SifGenerationRequest): SifGenerationContext;
+/**
+ * Phase 2: Finalize SIF generation.
+ *
+ * Validates the LLM-generated XML, checks for collisions with existing objects,
+ * runs best-practice checks, and indexes the result into the knowledge store.
+ */
+export declare function finalizeSifGeneration(knowledgeStore: KnowledgeStore, generatedXml: string, request: SifGenerationRequest): SifGenerationResult;
+//# sourceMappingURL=sif-generator.d.ts.map

package/dist/core/siebel/sif-generator.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"sif-generator.d.ts","sourceRoot":"","sources":["../../../src/core/siebel/sif-generator.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,EAAE,cAAc,EAAE,MAAM,6BAA6B,CAAC;AAI7D,OAAO,EAEL,KAAK,oBAAoB,EAC1B,MAAM,4BAA4B,CAAC;AACpC,OAAO,KAAK,EACV,oBAAoB,EACpB,mBAAmB,EAGpB,MAAM,gCAAgC,CAAC;AAExC;;;;;GAKG;AACH,wBAAgB,oBAAoB,CAClC,cAAc,EAAE,cAAc,EAC9B,OAAO,EAAE,oBAAoB,GAC5B,oBAAoB,CAOtB;AAED;;;;;GAKG;AACH,wBAAgB,qBAAqB,CACnC,cAAc,EAAE,cAAc,EAC9B,YAAY,EAAE,MAAM,EACpB,OAAO,EAAE,oBAAoB,GAC5B,mBAAmB,CAsFrB"}

package/dist/core/siebel/sif-generator.js

@@ -0,0 +1,232 @@
+/**
+ * SIF Generator — two-phase SIF generation pipeline.
+ *
+ * Phase 1 (prepare): Assembles RAG context + prompt for the LLM.
+ * Phase 2 (finalize): Validates LLM output, indexes into knowledge store.
+ *
+ * The module does NOT call any LLM — it stays pure and testable.
+ */
+import { logger } from "../utils/logger.js";
+import { parseSifContent } from "./sif-parser.js";
+import { indexSifContent } from "../../core/rag/siebel-indexer.js";
+import { assembleSifContext, } from "./sif-context-assembler.js";
+/**
+ * Phase 1: Prepare SIF generation context.
+ *
+ * Returns a structured context with prompt, templates, existing objects,
+ * and validation rules for the LLM to use.
+ */
+export function prepareSifGeneration(knowledgeStore, request) {
+    logger.info("Preparing SIF generation", {
+        types: request.objectTypes.join(","),
+        description: request.description.slice(0, 100),
+    });
+    return assembleSifContext(knowledgeStore, request);
+}
+/**
+ * Phase 2: Finalize SIF generation.
+ *
+ * Validates the LLM-generated XML, checks for collisions with existing objects,
+ * runs best-practice checks, and indexes the result into the knowledge store.
+ */
+export function finalizeSifGeneration(knowledgeStore, generatedXml, request) {
+    logger.info("Finalizing SIF generation", {
+        xmlLength: String(generatedXml.length),
+        requestTypes: request.objectTypes.join(","),
+    });
+    const messages = [];
+    // 1. Parse the generated XML
+    let parseResult;
+    try {
+        parseResult = parseSifContent(generatedXml, "generated.sif");
+        messages.push({
+            level: "info",
+            message: `Parsed ${parseResult.objects.length} objects, ${parseResult.dependencies.length} dependencies`,
+        });
+    }
+    catch (err) {
+        const errMsg = err instanceof Error ? err.message : String(err);
+        logger.error("SIF generation validation failed: invalid XML", { error: errMsg });
+        messages.push({
+            level: "error",
+            message: `Invalid SIF XML: ${errMsg}`,
+        });
+        return {
+            sifContent: generatedXml,
+            objects: [],
+            validation: {
+                status: "invalid",
+                messages,
+                score: 0,
+            },
+            metadata: {
+                generatedAt: new Date().toISOString(),
+                requestDescription: request.description,
+                objectCount: 0,
+            },
+        };
+    }
+    // 2. Check for name collisions with existing objects
+    checkNameCollisions(knowledgeStore, parseResult, messages);
+    // 3. Run best-practice checks
+    runBestPracticeChecks(parseResult, messages);
+    // 4. Calculate score
+    const score = calculateScore(parseResult, messages);
+    // 5. Determine status
+    const hasErrors = messages.some((m) => m.level === "error");
+    const hasWarnings = messages.some((m) => m.level === "warning");
+    const status = hasErrors ? "invalid" : hasWarnings ? "warnings" : "valid";
+    // 6. Index into knowledge store (only if valid or warnings)
+    if (!hasErrors) {
+        try {
+            indexSifContent(knowledgeStore, parseResult);
+            logger.info("Generated SIF indexed into knowledge store", {
+                objectCount: String(parseResult.objects.length),
+            });
+        }
+        catch (err) {
+            logger.error("Failed to index generated SIF", {
+                error: err instanceof Error ? err.message : String(err),
+            });
+        }
+    }
+    const result = {
+        sifContent: generatedXml,
+        objects: parseResult.objects.map((o) => ({ name: o.name, type: o.type })),
+        validation: { status, messages, score },
+        metadata: {
+            generatedAt: new Date().toISOString(),
+            requestDescription: request.description,
+            objectCount: parseResult.objects.length,
+        },
+    };
+    logger.info("SIF generation finalized", {
+        status,
+        score: String(score),
+        objectCount: String(parseResult.objects.length),
+    });
+    return result;
+}
+function checkNameCollisions(knowledgeStore, parseResult, messages) {
+    for (const obj of parseResult.objects) {
+        try {
+            // Search by object name — simpler query for better FTS5 matching
+            const existing = knowledgeStore.search(obj.name, 10);
+            const collision = existing.find((doc) => doc.sourceType === "siebel_sif" &&
+                doc.title.toLowerCase().includes(obj.name.toLowerCase()) &&
+                (doc.title.toLowerCase().includes(obj.type) ||
+                    doc.title.toLowerCase().includes(obj.type.replace(/_/g, " "))));
+            if (collision) {
+                messages.push({
+                    level: "warning",
+                    message: `Name collision: ${obj.type} "${obj.name}" already exists in indexed objects`,
+                    objectName: obj.name,
+                });
+            }
+        }
+        catch {
+            // Search might fail on empty knowledge store — that's OK
+        }
+    }
+}
+function runBestPracticeChecks(parseResult, messages) {
+    for (const obj of parseResult.objects) {
+        // BCs without TABLE
+        if (obj.type === "business_component") {
+            const hasTable = obj.properties.some((p) => p.name === "TABLE");
+            if (!hasTable) {
+                messages.push({
+                    level: "warning",
+                    message: `Business Component "${obj.name}" is missing TABLE attribute`,
+                    objectName: obj.name,
+                });
+            }
+        }
+        // Applets without BUS_COMP
+        if (obj.type === "applet") {
+            const hasBusComp = obj.properties.some((p) => p.name === "BUS_COMP");
+            if (!hasBusComp) {
+                messages.push({
+                    level: "warning",
+                    message: `Applet "${obj.name}" is missing BUS_COMP attribute`,
+                    objectName: obj.name,
+                });
+            }
+        }
+        // Views without BUS_OBJECT
+        if (obj.type === "view") {
+            const hasBusObject = obj.properties.some((p) => p.name === "BUS_OBJECT");
+            if (!hasBusObject) {
+                messages.push({
+                    level: "warning",
+                    message: `View "${obj.name}" is missing BUS_OBJECT attribute`,
+                    objectName: obj.name,
+                });
+            }
+        }
+        // Objects without name (shouldn't happen but defensive)
+        if (!obj.name || obj.name.trim() === "") {
+            messages.push({
+                level: "error",
+                message: "Object found without a NAME attribute",
+                objectName: "unknown",
+            });
+        }
+    }
+    // Check circular dependencies
+    if (parseResult.dependencies.length > 0) {
+        // Build adjacency map for cycle detection
+        const adjMap = new Map();
+        for (const dep of parseResult.dependencies) {
+            const fromKey = `${dep.from.type}:${dep.from.name}`;
+            const toKey = `${dep.to.type}:${dep.to.name}`;
+            const existing = adjMap.get(fromKey) ?? [];
+            existing.push(toKey);
+            adjMap.set(fromKey, existing);
+        }
+        // Simple DFS cycle detection
+        const visited = new Set();
+        const inStack = new Set();
+        function hasCycle(node) {
+            visited.add(node);
+            inStack.add(node);
+            for (const neighbor of adjMap.get(node) ?? []) {
+                if (inStack.has(neighbor))
+                    return true;
+                if (!visited.has(neighbor) && hasCycle(neighbor))
+                    return true;
+            }
+            inStack.delete(node);
+            return false;
+        }
+        for (const key of adjMap.keys()) {
+            if (!visited.has(key) && hasCycle(key)) {
+                messages.push({
+                    level: "warning",
+                    message: "Circular dependency detected in generated objects",
+                });
+                break;
+            }
+        }
+    }
+}
+function calculateScore(parseResult, messages) {
+    let score = 100;
+    const errors = messages.filter((m) => m.level === "error").length;
+    const warnings = messages.filter((m) => m.level === "warning").length;
+    // Deduct for errors
+    score -= errors * 30;
+    // Deduct for warnings
+    score -= warnings * 10;
+    // Bonus for having dependencies (well-connected objects)
+    if (parseResult.dependencies.length > 0) {
+        score = Math.min(score + 5, 100);
+    }
+    // Bonus for having children (detailed objects)
+    const hasChildren = parseResult.objects.some((o) => o.children.length > 0);
+    if (hasChildren) {
+        score = Math.min(score + 5, 100);
+    }
+    return Math.max(0, Math.min(100, score));
+}
+//# sourceMappingURL=sif-generator.js.map

package/dist/core/siebel/sif-generator.js.map

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

package/dist/core/siebel/sif-parser.d.ts

@@ -0,0 +1,16 @@
+/**
+ * SIF Parser — parses Siebel Import Files (.sif) into typed Siebel objects.
+ *
+ * SIF files are XML-based archives following the hierarchy:
+ * Repository → Project → Object Types (Applet, BC, BO, etc.) → Child Elements
+ */
+import type { SiebelSifParseResult } from "../../schemas/siebel.schema.js";
+/**
+ * Parse SIF XML content string into typed Siebel objects.
+ */
+export declare function parseSifContent(content: string, fileName: string): SiebelSifParseResult;
+/**
+ * Parse SIF from a file path.
+ */
+export declare function parseSifFile(filePath: string): Promise<SiebelSifParseResult>;
+//# sourceMappingURL=sif-parser.d.ts.map

package/dist/core/siebel/sif-parser.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"sif-parser.d.ts","sourceRoot":"","sources":["../../../src/core/siebel/sif-parser.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAOH,OAAO,KAAK,EAKV,oBAAoB,EAErB,MAAM,gCAAgC,CAAC;AA0CxC;;GAEG;AACH,wBAAgB,eAAe,CAAC,OAAO,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,oBAAoB,CAqEvF;AAED;;GAEG;AACH,wBAAsB,YAAY,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,oBAAoB,CAAC,CASlF"}

package/dist/core/siebel/sif-parser.js

@@ -0,0 +1,355 @@
+/**
+ * SIF Parser — parses Siebel Import Files (.sif) into typed Siebel objects.
+ *
+ * SIF files are XML-based archives following the hierarchy:
+ * Repository → Project → Object Types (Applet, BC, BO, etc.) → Child Elements
+ */
+import { XMLParser } from "fast-xml-parser";
+import { readFile } from "node:fs/promises";
+import { basename } from "node:path";
+import { logger } from "../utils/logger.js";
+import { FileNotFoundError, ValidationError } from "../utils/errors.js";
+/**
+ * Mapping from SIF XML tag names to Siebel object types.
+ */
+const TAG_TO_TYPE = {
+    APPLET: "applet",
+    BUSINESS_COMPONENT: "business_component",
+    BUSINESS_OBJECT: "business_object",
+    VIEW: "view",
+    SCREEN: "screen",
+    WORKFLOW: "workflow",
+    INTEGRATION_OBJECT: "integration_object",
+    BUSINESS_SERVICE: "business_service",
+    WEB_TEMPLATE: "web_template",
+    PICK_LIST: "pick_list",
+    TABLE: "table",
+};
+/**
+ * Child element tag names and their mapped types.
+ */
+const CHILD_TAG_TO_TYPE = {
+    FIELD: "field",
+    COLUMN: "column",
+    CONTROL: "control",
+    LIST_COLUMN: "list_column",
+    LINK: "link",
+    APPLET_WEB_TEMPLATE: "web_template",
+    VIEW_WEB_TEMPLATE: "web_template",
+    VIEW_APPLET: "applet",
+    SCREEN_VIEW: "view",
+    APPLET_METHOD_MENU_ITEM: "menu_item",
+    BUSINESS_OBJECT_COMPONENT: "business_component",
+    BUSINESS_SERVICE_METHOD: "business_service",
+    WORKFLOW_STEP: "workflow",
+    INTEGRATION_COMPONENT: "business_component",
+};
+/** Reserved XML attribute names that are not properties. */
+const RESERVED_ATTRS = new Set(["NAME", "INACTIVE"]);
+/**
+ * Parse SIF XML content string into typed Siebel objects.
+ */
+export function parseSifContent(content, fileName) {
+    if (!content || content.trim().length === 0) {
+        throw new ValidationError("SIF content is empty", [{ field: "content", message: "empty" }]);
+    }
+    const parser = new XMLParser({
+        ignoreAttributes: false,
+        attributeNamePrefix: "@_",
+        allowBooleanAttributes: true,
+        parseAttributeValue: false,
+        isArray: () => {
+            // Force array for repeating elements
+            return true;
+        },
+    });
+    let parsed;
+    try {
+        parsed = parser.parse(content);
+    }
+    catch (err) {
+        throw new ValidationError("Invalid SIF XML", [
+            { field: "xml", message: err instanceof Error ? err.message : String(err) },
+        ]);
+    }
+    // Navigate to REPOSITORY root
+    const repositories = getArray(parsed, "REPOSITORY");
+    if (repositories.length === 0) {
+        throw new ValidationError("SIF file missing REPOSITORY root element", [
+            { field: "structure", message: "no REPOSITORY found" },
+        ]);
+    }
+    const repo = repositories[0];
+    const repositoryName = getAttr(repo, "NAME") ?? "Unknown";
+    // Navigate to PROJECT(s)
+    const projects = getArray(repo, "PROJECT");
+    const projectName = projects.length > 0 ? getAttr(projects[0], "NAME") : undefined;
+    const objects = [];
+    for (const proj of projects) {
+        const projObj = proj;
+        const projName = getAttr(projObj, "NAME") ?? "Unknown";
+        extractObjectsFromProject(projObj, projName, objects);
+    }
+    const dependencies = inferDependencies(objects);
+    const objectTypes = [...new Set(objects.map((o) => o.type))];
+    const metadata = {
+        fileName,
+        repositoryName,
+        projectName,
+        objectCount: objects.length,
+        objectTypes,
+        extractedAt: new Date().toISOString(),
+    };
+    logger.info("SIF parsed", {
+        fileName,
+        objectCount: String(objects.length),
+        dependencyCount: String(dependencies.length),
+        objectTypes: objectTypes.join(","),
+    });
+    return { metadata, objects, dependencies };
+}
+/**
+ * Parse SIF from a file path.
+ */
+export async function parseSifFile(filePath) {
+    let content;
+    try {
+        content = await readFile(filePath, "utf-8");
+    }
+    catch {
+        throw new FileNotFoundError(filePath);
+    }
+    return parseSifContent(content, basename(filePath));
+}
+/**
+ * Extract top-level objects from a PROJECT element.
+ */
+function extractObjectsFromProject(projObj, projectName, objects) {
+    for (const [tag, siebelType] of Object.entries(TAG_TO_TYPE)) {
+        const elements = getArray(projObj, tag);
+        for (const elem of elements) {
+            const obj = elementToSiebelObject(elem, siebelType, projectName);
+            if (obj) {
+                objects.push(obj);
+            }
+        }
+    }
+}
+/**
+ * Convert a single XML element into a SiebelObject.
+ */
+function elementToSiebelObject(elem, type, projectName) {
+    const name = getAttr(elem, "NAME");
+    if (!name)
+        return null;
+    const properties = extractProperties(elem);
+    const children = extractChildren(elem, name);
+    const inactive = getAttr(elem, "INACTIVE") === "Y";
+    return {
+        name,
+        type,
+        project: projectName,
+        properties,
+        children,
+        inactive: inactive || undefined,
+    };
+}
+/**
+ * Extract properties from element attributes.
+ */
+function extractProperties(elem) {
+    const props = [];
+    for (const [key, value] of Object.entries(elem)) {
+        if (key.startsWith("@_") && !RESERVED_ATTRS.has(key.slice(2))) {
+            props.push({ name: key.slice(2), value: String(value) });
+        }
+    }
+    return props;
+}
+/**
+ * Extract child elements from a parent element.
+ */
+function extractChildren(elem, parentName) {
+    const children = [];
+    for (const [tag, childType] of Object.entries(CHILD_TAG_TO_TYPE)) {
+        const elements = getArray(elem, tag);
+        for (const child of elements) {
+            const childObj = child;
+            const name = getAttr(childObj, "NAME");
+            if (!name)
+                continue;
+            children.push({
+                name,
+                type: childType,
+                properties: extractProperties(childObj),
+                children: [],
+                parentName,
+            });
+        }
+    }
+    return children;
+}
+/**
+ * Infer dependencies between Siebel objects based on known patterns.
+ */
+function inferDependencies(objects) {
+    const deps = [];
+    const objectIndex = new Map();
+    for (const obj of objects) {
+        objectIndex.set(`${obj.type}:${obj.name}`, obj);
+    }
+    for (const obj of objects) {
+        // Applet → BC (via BUS_COMP attribute)
+        if (obj.type === "applet") {
+            const busComp = findProperty(obj, "BUS_COMP");
+            if (busComp && objectIndex.has(`business_component:${busComp}`)) {
+                deps.push({
+                    from: { name: obj.name, type: "applet" },
+                    to: { name: busComp, type: "business_component" },
+                    relationType: "references",
+                    inferred: true,
+                });
+            }
+        }
+        // View → BO (via BUS_OBJECT attribute)
+        if (obj.type === "view") {
+            const busObject = findProperty(obj, "BUS_OBJECT");
+            if (busObject && objectIndex.has(`business_object:${busObject}`)) {
+                deps.push({
+                    from: { name: obj.name, type: "view" },
+                    to: { name: busObject, type: "business_object" },
+                    relationType: "references",
+                    inferred: true,
+                });
+            }
+            // View → Applet (via VIEW_APPLET children)
+            for (const child of obj.children) {
+                if (child.type === "applet") {
+                    const appletName = findProperty(child, "APPLET") ?? child.name;
+                    if (objectIndex.has(`applet:${appletName}`)) {
+                        deps.push({
+                            from: { name: obj.name, type: "view" },
+                            to: { name: appletName, type: "applet" },
+                            relationType: "contains",
+                            inferred: true,
+                        });
+                    }
+                }
+            }
+        }
+        // Screen → View (via SCREEN_VIEW children)
+        if (obj.type === "screen") {
+            for (const child of obj.children) {
+                if (child.type === "view") {
+                    const viewName = findProperty(child, "VIEW") ?? child.name;
+                    if (objectIndex.has(`view:${viewName}`)) {
+                        deps.push({
+                            from: { name: obj.name, type: "screen" },
+                            to: { name: viewName, type: "view" },
+                            relationType: "contains",
+                            inferred: true,
+                        });
+                    }
+                }
+            }
+        }
+        // BO → BC (via BUSINESS_OBJECT_COMPONENT children)
+        if (obj.type === "business_object") {
+            for (const child of obj.children) {
+                if (child.type === "business_component") {
+                    const bcName = findProperty(child, "BUS_COMP") ?? child.name;
+                    if (objectIndex.has(`business_component:${bcName}`)) {
+                        deps.push({
+                            from: { name: obj.name, type: "business_object" },
+                            to: { name: bcName, type: "business_component" },
+                            relationType: "contains",
+                            inferred: true,
+                        });
+                    }
+                }
+            }
+        }
+        // Workflow → BO (via BUS_OBJECT attribute)
+        if (obj.type === "workflow") {
+            const busObject = findProperty(obj, "BUS_OBJECT");
+            if (busObject && objectIndex.has(`business_object:${busObject}`)) {
+                deps.push({
+                    from: { name: obj.name, type: "workflow" },
+                    to: { name: busObject, type: "business_object" },
+                    relationType: "references",
+                    inferred: true,
+                });
+            }
+            // Workflow → BS (via workflow steps)
+            for (const child of obj.children) {
+                const busService = findProperty(child, "BUS_SERVICE");
+                if (busService && objectIndex.has(`business_service:${busService}`)) {
+                    deps.push({
+                        from: { name: obj.name, type: "workflow" },
+                        to: { name: busService, type: "business_service" },
+                        relationType: "uses",
+                        inferred: true,
+                    });
+                }
+            }
+        }
+        // Integration Object → BC (via BUS_COMP attribute or INTEGRATION_COMPONENT children)
+        if (obj.type === "integration_object") {
+            const busComp = findProperty(obj, "BUS_COMP");
+            if (busComp && objectIndex.has(`business_component:${busComp}`)) {
+                deps.push({
+                    from: { name: obj.name, type: "integration_object" },
+                    to: { name: busComp, type: "business_component" },
+                    relationType: "references",
+                    inferred: true,
+                });
+            }
+        }
+        // BC → Table (via TABLE attribute)
+        if (obj.type === "business_component") {
+            const table = findProperty(obj, "TABLE");
+            if (table) {
+                deps.push({
+                    from: { name: obj.name, type: "business_component" },
+                    to: { name: table, type: "table" },
+                    relationType: "based_on",
+                    inferred: true,
+                });
+            }
+            // BC → BC (via LINK children's CHILD_BC)
+            for (const child of obj.children) {
+                if (child.type === "link") {
+                    const childBc = findProperty(child, "CHILD_BC");
+                    if (childBc && objectIndex.has(`business_component:${childBc}`)) {
+                        deps.push({
+                            from: { name: obj.name, type: "business_component" },
+                            to: { name: childBc, type: "business_component" },
+                            relationType: "linked_to",
+                            inferred: true,
+                        });
+                    }
+                }
+            }
+        }
+    }
+    return deps;
+}
+/** Find a property value by name. */
+function findProperty(obj, propName) {
+    return obj.properties.find((p) => p.name === propName)?.value;
+}
+/** Safely get an array of elements from parsed XML. */
+function getArray(obj, key) {
+    const val = obj[key];
+    if (Array.isArray(val))
+        return val;
+    if (val != null)
+        return [val];
+    return [];
+}
+/** Get an XML attribute value. */
+function getAttr(obj, name) {
+    const val = obj[`@_${name}`];
+    return val != null ? String(val) : undefined;
+}
+//# sourceMappingURL=sif-parser.js.map