workday-studio-mcp-server 2.0.1 → 2.0.2

package/dist/tools/update-sub-flow.js

@@ -0,0 +1,185 @@
+/**
+ * update_sub_flow — replace the <cc:steps> body of a named sub-flow in assembly.xml.
+ * Ported from the reference implementation (update-sub-flow.mjs).
+ */
+import { z } from 'zod';
+import { readFile, writeFile } from 'fs/promises';
+import { join, resolve } from 'path';
+import { existsSync } from 'fs';
+import { getConfig } from '../config.js';
+import { errorResponse } from '../utils/errors.js';
+import { validateAssembly, checkDiagramDrift } from '../utils/assembly-validator.js';
+import { backupFile } from '../utils/fs.js';
+import { validateXml } from '../utils/xml.js';
+export function register(server) {
+    server.tool('update_sub_flow', [
+        'Replaces the <cc:steps> body of a named sub-flow in assembly.xml.',
+        'Use this to fill in a TODO stub generated by plan_integration.',
+        '',
+        'Finds <cc:async-mediation id="Do{sub_flow_id}"> and replaces its <cc:steps>',
+        'content with steps_xml. Everything else on the async-mediation is preserved:',
+        'routes-to, handle-downstream-errors, and the trailing <cc:send-error>.',
+        '',
+        'steps_xml format:',
+        '  - Provide the step elements that go INSIDE <cc:steps>. Do not include the wrapper.',
+        '  - Use \\t for tabs. Steps should sit at 4-tab depth (matching skeleton indent).',
+        '  - Example for a RAAS fetch + eval:',
+        '      \\t\\t\\t\\t<cc:workday-out-rest id="GetWorkers" routes-response-to="TODO_next"',
+        '      \\t\\t\\t\\t  extra-path="@{intsys.reportService.getExtrapath(\'alias\')}"/>',
+        '',
+        'TOP-LEVEL ELEMENTS WARNING (Studio schema rule confirmed INT095, INT069, INT144):',
+        'The following elements CANNOT appear inside steps_xml — they MUST be top-level',
+        'elements placed directly inside <cc:assembly>, not inside <cc:steps>:',
+        '  - cc:workday-out-rest',
+        '  - cc:splitter',
+        '  - cc:http-out',
+        '  - cc:email-out',
+        '  - cc:workday-out-soap',
+        'If your sub-flow needs to call any of these, place them as top-level elements in',
+        'the assembly and chain to them via routes-to on the async-mediation itself.',
+        'The validate_assembly tool will catch this mistake automatically.',
+        '',
+        'A .bak backup is written before every change.',
+        'XML well-formedness is validated before the write is committed.',
+        '',
+        'To also change the routes-to on the async-mediation itself (e.g. from',
+        '"EndGetWorkers" to "Splitter"), use write_integration_file for a full rewrite.',
+    ].join('\n'), {
+        project_name: z.string()
+            .describe('Project name, e.g. "INT145_My_Integration"'),
+        sub_flow_id: z.string()
+            .describe('Base id used in plan_integration, e.g. "GetWorkers" (NOT "DoGetWorkers"). The tool looks for id="Do{sub_flow_id}" in the assembly.'),
+        steps_xml: z.string()
+            .describe('New step elements for inside <cc:steps>. Omit the <cc:steps> wrapper. Use \\t for tabs at 4-tab depth.'),
+    }, async ({ project_name, sub_flow_id, steps_xml }) => {
+        const cfg = getConfig();
+        const projectPath = resolve(cfg.workspacePath, project_name);
+        const assemblyPath = join(projectPath, 'ws', 'WSAR-INF', 'assembly.xml');
+        if (!existsSync(assemblyPath)) {
+            return errorResponse('FILE_NOT_FOUND', `assembly.xml not found in project '${project_name}'.`, 'Run plan_integration first to generate the skeleton.');
+        }
+        let original;
+        try {
+            original = await readFile(assemblyPath, 'utf-8');
+        }
+        catch (e) {
+            return errorResponse('READ_ERROR', e.message, null);
+        }
+        const result = replaceStepsBlock(original, sub_flow_id, steps_xml);
+        if (!result.ok) {
+            return errorResponse(result.code, result.message, result.suggestion);
+        }
+        const xmlValidation = validateXml(result.xml);
+        if (!xmlValidation.valid) {
+            return errorResponse('INVALID_XML', `The replacement would produce malformed XML: ${xmlValidation.errors.join('; ')}`, 'Check steps_xml for unclosed tags, unescaped & characters (use &amp;), or missing wd: namespace prefixes.');
+        }
+        const backupPath = await backupFile(assemblyPath);
+        try {
+            await writeFile(assemblyPath, result.xml, 'utf-8');
+        }
+        catch (e) {
+            return errorResponse('WRITE_FAILED', e.message, null);
+        }
+        // Studio-specific validation
+        const wsDir = join(projectPath, 'ws', 'WSAR-INF');
+        const issues = validateAssembly(result.xml, wsDir);
+        const errors = issues.filter(i => i.severity === 'ERROR');
+        const warnings = issues.filter(i => i.severity === 'WARNING');
+        // Diagram drift detection
+        const diagramPath = join(wsDir, 'assembly-diagram.xml');
+        let diagramDrift = null;
+        if (existsSync(diagramPath)) {
+            let diagramXml = null;
+            try {
+                diagramXml = await readFile(diagramPath, 'utf8');
+            }
+            catch { /* non-fatal */ }
+            if (diagramXml) {
+                const drifted = checkDiagramDrift(result.xml, diagramXml);
+                if (drifted.length > 0) {
+                    diagramDrift = {
+                        warning: `${drifted.length} element(s) in assembly.xml have no matching entry in assembly-diagram.xml.`,
+                        missing_from_diagram: drifted.map(d => `${d.tag} id="${d.id}"`),
+                    };
+                }
+            }
+        }
+        const backup = backupPath
+            ? 'ws/WSAR-INF/' + backupPath.split('/WSAR-INF/').pop()
+            : null;
+        return {
+            content: [{
+                    type: 'text',
+                    text: JSON.stringify({
+                        success: true,
+                        updated: `Do${sub_flow_id}`,
+                        backup,
+                        validation: {
+                            clean: issues.length === 0,
+                            errors: errors.length,
+                            warnings: warnings.length,
+                            issues: issues.length > 0 ? issues : undefined,
+                        },
+                        ...(diagramDrift ? { diagram_drift: diagramDrift } : {}),
+                        next_step: errors.length > 0
+                            ? 'Fix the ERRORs above before opening in Studio.'
+                            : diagramDrift
+                                ? 'Assembly valid. Update assembly-diagram.xml to add missing diagram entries before opening in Studio.'
+                                : 'Open assembly-diagram.xml in Studio to verify the diagram renders correctly.',
+                    }, null, 2),
+                }],
+        };
+    });
+}
+function replaceStepsBlock(xml, subFlowId, newStepsContent) {
+    const asyncMedTag = `<cc:async-mediation id="Do${subFlowId}"`;
+    const asyncMedStart = xml.indexOf(asyncMedTag);
+    if (asyncMedStart === -1) {
+        return {
+            ok: false,
+            code: 'SUB_FLOW_NOT_FOUND',
+            message: `No element with id="Do${subFlowId}" found in assembly.xml.`,
+            suggestion: `Check that sub_flow_id matches exactly what was passed to plan_integration. Run list_assembly_steps to see available ids.`,
+        };
+    }
+    const stepsOpenTag = '<cc:steps>';
+    const stepsCloseTag = '</cc:steps>';
+    const stepsOpenIdx = xml.indexOf(stepsOpenTag, asyncMedStart);
+    if (stepsOpenIdx === -1) {
+        return {
+            ok: false,
+            code: 'STEPS_NOT_FOUND',
+            message: `No <cc:steps> found inside Do${subFlowId}.`,
+            suggestion: 'The assembly.xml may have been manually modified. Check the file with read_integration_file.',
+        };
+    }
+    // Guard: no other async-mediation should appear between our tag and the steps open
+    const between = xml.substring(asyncMedStart + asyncMedTag.length, stepsOpenIdx);
+    if (between.includes('<cc:async-mediation')) {
+        return {
+            ok: false,
+            code: 'AMBIGUOUS_TARGET',
+            message: `Found an unexpected nested async-mediation before <cc:steps> in Do${subFlowId}.`,
+            suggestion: 'Use write_integration_file for a full rewrite instead.',
+        };
+    }
+    const stepsCloseIdx = xml.indexOf(stepsCloseTag, stepsOpenIdx + stepsOpenTag.length);
+    if (stepsCloseIdx === -1) {
+        return {
+            ok: false,
+            code: 'STEPS_UNCLOSED',
+            message: `No </cc:steps> closing tag found after <cc:steps> in Do${subFlowId}.`,
+            suggestion: 'assembly.xml may be malformed. Validate with validate_xml_file.',
+        };
+    }
+    // Detect the indentation of <cc:steps> so the closing tag stays aligned
+    const lineStart = xml.lastIndexOf('\n', stepsOpenIdx) + 1;
+    const stepsIndent = xml.substring(lineStart, stepsOpenIdx);
+    const before = xml.substring(0, stepsOpenIdx + stepsOpenTag.length);
+    const after = xml.substring(stepsCloseIdx); // starts with </cc:steps>
+    return {
+        ok: true,
+        xml: `${before}\n${newStepsContent}\n${stepsIndent}${after}`,
+    };
+}
+//# sourceMappingURL=update-sub-flow.js.map

package/dist/tools/update-sub-flow.js.map

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

package/dist/tools/validate-assembly.d.ts

@@ -0,0 +1,6 @@
+/**
+ * validate_assembly — run Studio-specific validation rules on a project's assembly.xml.
+ */
+import type { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
+export declare function register(server: McpServer): void;
+//# sourceMappingURL=validate-assembly.d.ts.map

package/dist/tools/validate-assembly.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"validate-assembly.d.ts","sourceRoot":"","sources":["../../src/tools/validate-assembly.ts"],"names":[],"mappings":"AAAA;;GAEG;AAMH,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AAKzE,wBAAgB,QAAQ,CAAC,MAAM,EAAE,SAAS,GAAG,IAAI,CA4FhD"}

package/dist/tools/validate-assembly.js

@@ -0,0 +1,94 @@
+/**
+ * validate_assembly — run Studio-specific validation rules on a project's assembly.xml.
+ */
+import { z } from 'zod';
+import { readFile } from 'fs/promises';
+import { join, resolve } from 'path';
+import { existsSync } from 'fs';
+import { getConfig } from '../config.js';
+import { errorResponse } from '../utils/errors.js';
+import { validateAssembly, checkDiagramDrift } from '../utils/assembly-validator.js';
+export function register(server) {
+    server.tool('validate_assembly', [
+        'Run Workday Studio-specific validation rules on a project\'s assembly.xml.',
+        '',
+        'Checks rules that XML well-formedness alone cannot catch:',
+        '  • No XML comments (they shift @mixed indices and break diagram connections)',
+        '  • All routes-to / routes-response-to targets exist',
+        '  • vm:// sub-flow endpoints resolve to real cc:local-in elements',
+        '  • Required attributes present (application=, version=, extra-path=, url=)',
+        '  • Top-level-only elements not nested inside <cc:steps>',
+        '  • cc:splitter has no routes-to attribute',
+        '  • XSL files referenced by url= exist in WSAR-INF',
+        '  • cc:note is not used (schema-invalid + crashes Studio diagram)',
+        '  • No TODO_ stub ids remaining',
+        '',
+        'Set check_diagram_drift=true to also compare assembly.xml element ids',
+        'against assembly-diagram.xml and report any renderable elements missing',
+        'from the diagram.',
+    ].join('\n'), {
+        project_name: z.string().describe('Studio project name.'),
+        check_diagram_drift: z.boolean().optional().describe('Also check for assembly elements missing from the diagram (default: false).'),
+    }, async ({ project_name, check_diagram_drift = false }) => {
+        const cfg = getConfig();
+        const wsarInfPath = resolve(cfg.workspacePath, project_name, 'ws', 'WSAR-INF');
+        const assemblyPath = join(wsarInfPath, 'assembly.xml');
+        const diagramPath = join(wsarInfPath, 'assembly-diagram.xml');
+        if (!existsSync(assemblyPath)) {
+            return errorResponse('ASSEMBLY_NOT_FOUND', `assembly.xml not found for project '${project_name}'.`, 'Check the project name or create the project first.');
+        }
+        let assemblyXml;
+        try {
+            assemblyXml = await readFile(assemblyPath, 'utf8');
+        }
+        catch (e) {
+            return errorResponse('READ_ERROR', e.message, null);
+        }
+        // Run assembly validation (pass wsarInfPath so XSL file checks work)
+        const issues = validateAssembly(assemblyXml, wsarInfPath);
+        const errors = issues.filter(i => i.severity === 'ERROR');
+        const warnings = issues.filter(i => i.severity === 'WARNING');
+        const infos = issues.filter(i => i.severity === 'INFO');
+        // Optional diagram drift check
+        let diagramDrift = null;
+        if (check_diagram_drift) {
+            if (existsSync(diagramPath)) {
+                try {
+                    const diagramXml = await readFile(diagramPath, 'utf8');
+                    diagramDrift = checkDiagramDrift(assemblyXml, diagramXml);
+                }
+                catch {
+                    diagramDrift = null;
+                }
+            }
+            else {
+                diagramDrift = [];
+            }
+        }
+        const result = {
+            project: project_name,
+            assembly_path: `ws/WSAR-INF/assembly.xml`,
+            summary: {
+                errors: errors.length,
+                warnings: warnings.length,
+                infos: infos.length,
+                total_issues: issues.length,
+                status: errors.length > 0 ? 'FAIL' : warnings.length > 0 ? 'WARN' : 'PASS',
+            },
+            issues: issues.length > 0 ? issues : [],
+        };
+        if (diagramDrift !== null) {
+            result['diagram_drift'] = {
+                missing_from_diagram: diagramDrift.length,
+                elements: diagramDrift,
+            };
+        }
+        return {
+            content: [{
+                    type: 'text',
+                    text: JSON.stringify(result, null, 2),
+                }],
+        };
+    });
+}
+//# sourceMappingURL=validate-assembly.js.map

package/dist/tools/validate-assembly.js.map

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

package/dist/utils/assembly-validator.d.ts

@@ -0,0 +1,18 @@
+/**
+ * Studio assembly validator — checks rules that XML well-formedness alone cannot catch.
+ *
+ * Returns an array of { severity, code, message } objects.
+ * severity: 'ERROR' (will break Studio) | 'WARNING' (will cause runtime failures) | 'INFO' (awareness)
+ */
+export interface AssemblyIssue {
+    severity: 'ERROR' | 'WARNING' | 'INFO';
+    code: string;
+    message: string;
+}
+export interface DiagramDriftItem {
+    tag: string;
+    id: string;
+}
+export declare function validateAssembly(xml: string, wsDir?: string | null): AssemblyIssue[];
+export declare function checkDiagramDrift(assemblyXml: string, diagramXml: string): DiagramDriftItem[];
+//# sourceMappingURL=assembly-validator.d.ts.map

package/dist/utils/assembly-validator.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"assembly-validator.d.ts","sourceRoot":"","sources":["../../src/utils/assembly-validator.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAKH,MAAM,WAAW,aAAa;IAC5B,QAAQ,EAAE,OAAO,GAAG,SAAS,GAAG,MAAM,CAAC;IACvC,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;CACjB;AAED,MAAM,WAAW,gBAAgB;IAC/B,GAAG,EAAE,MAAM,CAAC;IACZ,EAAE,EAAE,MAAM,CAAC;CACZ;AAED,wBAAgB,gBAAgB,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,GAAE,MAAM,GAAG,IAAW,GAAG,aAAa,EAAE,CAc1F;AA2LD,wBAAgB,iBAAiB,CAAC,WAAW,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,GAAG,gBAAgB,EAAE,CAa7F"}

package/dist/utils/assembly-validator.js

@@ -0,0 +1,202 @@
+/**
+ * Studio assembly validator — checks rules that XML well-formedness alone cannot catch.
+ *
+ * Returns an array of { severity, code, message } objects.
+ * severity: 'ERROR' (will break Studio) | 'WARNING' (will cause runtime failures) | 'INFO' (awareness)
+ */
+import { existsSync } from 'fs';
+import { join } from 'path';
+export function validateAssembly(xml, wsDir = null) {
+    const issues = [];
+    checkNoXmlComments(xml, issues);
+    checkBrokenRoutes(xml, issues);
+    checkLocalOutEndpoints(xml, issues);
+    checkRequiredAttributes(xml, issues);
+    checkTopLevelOnlyElements(xml, issues);
+    checkSplitterRoutes(xml, issues);
+    if (wsDir)
+        checkXslFileReferences(xml, wsDir, issues);
+    checkCcNote(xml, issues);
+    checkTodoStubs(xml, issues);
+    return issues;
+}
+// ─── Rule: no XML comments in assembly.xml ────────────────────────────────────
+// Comments are valid XML but shift @mixed indices, breaking all diagram EMF XPath references.
+function checkNoXmlComments(xml, issues) {
+    const matches = [...xml.matchAll(/<!--/g)];
+    if (matches.length > 0) {
+        issues.push({
+            severity: 'ERROR',
+            code: 'XML_COMMENTS_PRESENT',
+            message: `Found ${matches.length} XML comment(s). Comments shift @mixed indices and break all diagram connections. Remove every <!-- --> block from assembly.xml.`,
+        });
+    }
+}
+// ─── Rule: every routes-to / routes-response-to target must exist ─────────────
+function checkBrokenRoutes(xml, issues) {
+    const ids = collectIds(xml);
+    for (const m of xml.matchAll(/\broutes-to="([^"]+)"/g)) {
+        if (!ids.has(m[1])) {
+            issues.push({
+                severity: 'ERROR',
+                code: 'BROKEN_ROUTES_TO',
+                message: `routes-to="${m[1]}" — no element with this id exists in assembly.xml.`,
+            });
+        }
+    }
+    for (const m of xml.matchAll(/\broutes-response-to="([^"]+)"/g)) {
+        if (!ids.has(m[1])) {
+            issues.push({
+                severity: 'ERROR',
+                code: 'BROKEN_ROUTES_RESPONSE_TO',
+                message: `routes-response-to="${m[1]}" — no element with this id exists in assembly.xml.`,
+            });
+        }
+    }
+}
+// ─── Rule: vm:// sub-flow endpoints must point to a real cc:local-in ──────────
+// Built-in wcc/* endpoints are exempt.
+function checkLocalOutEndpoints(xml, issues) {
+    const ids = collectIds(xml);
+    for (const m of xml.matchAll(/endpoint="vm:\/\/([^/]+)\/([^"]+)"/g)) {
+        const systemName = m[1];
+        const localInId = m[2];
+        if (systemName === 'wcc')
+            continue; // built-in platform endpoints
+        if (!ids.has(localInId)) {
+            issues.push({
+                severity: 'WARNING',
+                code: 'UNRESOLVED_LOCAL_IN',
+                message: `vm://${systemName}/${localInId} — no cc:local-in with id="${localInId}" found. Either the local-in is missing or the id is misspelled.`,
+            });
+        }
+    }
+}
+// ─── Rule: required attributes per step type ─────────────────────────────────
+function checkRequiredAttributes(xml, issues) {
+    for (const tagMatch of xml.matchAll(/<cc:[a-z-]+\b[^>]*(?:\/>|>)/gs)) {
+        const tagText = tagMatch[0];
+        const nameMatch = tagText.match(/^<(cc:[a-z-]+)/);
+        if (!nameMatch)
+            continue;
+        const tagName = nameMatch[1];
+        // workday-out-soap: check application
+        if (tagName === 'cc:workday-out-soap') {
+            if (!tagText.includes('application=')) {
+                issues.push({ severity: 'ERROR', code: 'MISSING_ATTR_APPLICATION', message: `cc:workday-out-soap (id="${extractId(tagText)}") is missing required attribute application= (e.g. Human_Resources).` });
+            }
+            if (!tagText.includes('version=')) {
+                issues.push({ severity: 'ERROR', code: 'MISSING_ATTR_VERSION', message: `cc:workday-out-soap (id="${extractId(tagText)}") is missing required attribute version= (e.g. v46.1).` });
+            }
+        }
+        // workday-out-rest: check extra-path
+        if (tagName === 'cc:workday-out-rest' && !tagText.includes('extra-path=')) {
+            issues.push({ severity: 'ERROR', code: 'MISSING_ATTR_EXTRA_PATH', message: `cc:workday-out-rest (id="${extractId(tagText)}") is missing required attribute extra-path=.` });
+        }
+        // http-out: check endpoint
+        if (tagName === 'cc:http-out' && !tagText.includes('endpoint=')) {
+            issues.push({ severity: 'ERROR', code: 'MISSING_ATTR_ENDPOINT', message: `cc:http-out (id="${extractId(tagText)}") is missing required attribute endpoint=.` });
+        }
+        // xslt-plus: check url
+        if (tagName === 'cc:xslt-plus' && !tagText.includes('url=')) {
+            issues.push({ severity: 'ERROR', code: 'MISSING_ATTR_URL', message: `cc:xslt-plus (id="${extractId(tagText)}") is missing required attribute url= (path to .xsl file).` });
+        }
+    }
+}
+// ─── Rule: certain elements must be TOP-LEVEL, not inside cc:steps ───────────
+const TOP_LEVEL_ONLY = ['cc:workday-out-rest', 'cc:splitter', 'cc:http-out', 'cc:email-out', 'cc:workday-out-soap'];
+function checkTopLevelOnlyElements(xml, issues) {
+    const stepsPattern = /<cc:steps>([\s\S]*?)<\/cc:steps>/g;
+    for (const stepsMatch of xml.matchAll(stepsPattern)) {
+        const stepsContent = stepsMatch[1];
+        for (const tag of TOP_LEVEL_ONLY) {
+            if (stepsContent.includes(`<${tag}`)) {
+                const stepsIdx = stepsMatch.index;
+                const before = xml.substring(0, stepsIdx);
+                const asyncMedMatches = [...before.matchAll(/<cc:async-mediation\b[^>]*>/g)];
+                const asyncMedMatch = asyncMedMatches[asyncMedMatches.length - 1];
+                const containerId = asyncMedMatch ? extractId(asyncMedMatch[0]) : '?';
+                issues.push({
+                    severity: 'ERROR',
+                    code: 'ELEMENT_INSIDE_STEPS',
+                    message: `<${tag}> found inside <cc:steps> of "${containerId}". This is a top-level assembly element — it must sit directly inside <cc:assembly>, not inside cc:steps. Move it out of the async-mediation and chain it via routes-to/routes-response-to.`,
+                });
+            }
+        }
+    }
+}
+// ─── Rule: cc:splitter must NOT have a routes-to attribute ───────────────────
+function checkSplitterRoutes(xml, issues) {
+    for (const m of xml.matchAll(/<cc:splitter\b[^>]*>/g)) {
+        if (m[0].includes('routes-to=')) {
+            issues.push({
+                severity: 'ERROR',
+                code: 'SPLITTER_HAS_ROUTES_TO',
+                message: `cc:splitter (id="${extractId(m[0])}") has a routes-to attribute — the Studio schema does not allow this. Remove routes-to from the splitter. Routing is done via cc:sub-route children only.`,
+            });
+        }
+    }
+}
+// ─── Rule: XSL files referenced by url= must exist in WSAR-INF ───────────────
+function checkXslFileReferences(xml, wsDir, issues) {
+    for (const m of xml.matchAll(/\burl="([^"]+\.xslt?)"/g)) {
+        const xslFile = m[1];
+        if (!existsSync(join(wsDir, xslFile))) {
+            issues.push({
+                severity: 'WARNING',
+                code: 'MISSING_XSL_FILE',
+                message: `url="${xslFile}" — file not found in WSAR-INF. Create it with create_xsl_transform before testing.`,
+            });
+        }
+    }
+}
+// ─── Rule: cc:note is schema-invalid in assembly.xml ─────────────────────────
+function checkCcNote(xml, issues) {
+    const matches = [...xml.matchAll(/<cc:note\b/g)];
+    if (matches.length > 0) {
+        issues.push({
+            severity: 'ERROR',
+            code: 'CC_NOTE_IN_ASSEMBLY',
+            message: `Found ${matches.length} <cc:note> element(s). cc:note is schema-invalid in assembly.xml and crashes Studio if added to assembly-diagram.xml. Replace with an cc:async-mediation that has no routes-to attribute — that is the correct terminal pattern.`,
+        });
+    }
+}
+// ─── Rule: flag remaining TODO stubs ─────────────────────────────────────────
+function checkTodoStubs(xml, issues) {
+    const todos = [...xml.matchAll(/id="TODO_([^"]+)"/g)].map(m => m[1]);
+    if (todos.length > 0) {
+        issues.push({
+            severity: 'INFO',
+            code: 'TODO_STUBS_REMAINING',
+            message: `${todos.length} sub-flow(s) still contain TODO stubs: ${todos.join(', ')}. Fill these in with update_sub_flow before testing.`,
+        });
+    }
+}
+// ─── Diagram drift detection ──────────────────────────────────────────────────
+const RENDERABLE_TAGS = new Set([
+    'cc:workday-in', 'cc:local-out', 'cc:local-in', 'cc:async-mediation',
+    'cc:route', 'cc:splitter', 'cc:aggregator', 'cc:http-out',
+    'cc:workday-out-rest', 'cc:workday-out-soap', 'cc:email-out',
+]);
+export function checkDiagramDrift(assemblyXml, diagramXml) {
+    const missing = [];
+    for (const m of assemblyXml.matchAll(/<(cc:[a-z-]+)\b[^>]*\bid="([^"]+)"/g)) {
+        const tag = m[1];
+        const id = m[2];
+        if (!RENDERABLE_TAGS.has(tag))
+            continue;
+        if (!diagramXml.includes(`#${id}`)) {
+            missing.push({ tag, id });
+        }
+    }
+    return missing;
+}
+// ─── Helpers ──────────────────────────────────────────────────────────────────
+function collectIds(xml) {
+    return new Set([...xml.matchAll(/\bid="([^"]+)"/g)].map(m => m[1]));
+}
+function extractId(tagText) {
+    const m = tagText.match(/\bid="([^"]+)"/);
+    return m ? m[1] : '?';
+}
+//# sourceMappingURL=assembly-validator.js.map

package/dist/utils/assembly-validator.js.map

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

package/dist/utils/fs.d.ts

@@ -1,5 +1,5 @@
 /**
- * Safe filesystem helpers — path traversal protection.
+ * Safe filesystem helpers — path traversal protection + backup.
  */
 export interface ResolvedPath {
     absolute: string;
@@ -14,4 +14,9 @@ export declare function resolveSafe(projectName: string, filePath: string): Reso
  * Resolve a path directly under the workspace root, rejecting traversal.
  */
 export declare function resolveWorkspacePath(...parts: string[]): string;
+/**
+ * Write a .bak copy of a file next to the original.
+ * Returns the backup path, or null if the copy failed (non-fatal).
+ */
+export declare function backupFile(filePath: string): Promise<string | null>;
 //# sourceMappingURL=fs.d.ts.map

package/dist/utils/fs.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"fs.d.ts","sourceRoot":"","sources":["../../src/utils/fs.ts"],"names":[],"mappings":"AAAA;;GAEG;AAKH,MAAM,WAAW,YAAY;IAC3B,QAAQ,EAAE,MAAM,CAAC;IACjB,QAAQ,EAAE,MAAM,CAAC;CAClB;AAED;;;GAGG;AACH,wBAAgB,WAAW,CAAC,WAAW,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,YAAY,CAe/E;AAED;;GAEG;AACH,wBAAgB,oBAAoB,CAAC,GAAG,KAAK,EAAE,MAAM,EAAE,GAAG,MAAM,CAc/D"}
+{"version":3,"file":"fs.d.ts","sourceRoot":"","sources":["../../src/utils/fs.ts"],"names":[],"mappings":"AAAA;;GAEG;AAMH,MAAM,WAAW,YAAY;IAC3B,QAAQ,EAAE,MAAM,CAAC;IACjB,QAAQ,EAAE,MAAM,CAAC;CAClB;AAED;;;GAGG;AACH,wBAAgB,WAAW,CAAC,WAAW,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,YAAY,CAe/E;AAED;;GAEG;AACH,wBAAgB,oBAAoB,CAAC,GAAG,KAAK,EAAE,MAAM,EAAE,GAAG,MAAM,CAc/D;AAED;;;GAGG;AACH,wBAAsB,UAAU,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,CAQzE"}

package/dist/utils/fs.js

@@ -1,7 +1,8 @@
 /**
- * Safe filesystem helpers — path traversal protection.
+ * Safe filesystem helpers — path traversal protection + backup.
  */
 import { resolve, join } from 'path';
+import { copyFile } from 'fs/promises';
 import { getConfig } from '../config.js';
 /**
  * Resolve a project-relative file path, rejecting any traversal outside the workspace.
@@ -32,4 +33,18 @@ export function resolveWorkspacePath(...parts) {
     }
     return absolute;
 }
+/**
+ * Write a .bak copy of a file next to the original.
+ * Returns the backup path, or null if the copy failed (non-fatal).
+ */
+export async function backupFile(filePath) {
+    const backupPath = filePath + '.bak';
+    try {
+        await copyFile(filePath, backupPath);
+        return backupPath;
+    }
+    catch {
+        return null;
+    }
+}
 //# sourceMappingURL=fs.js.map

package/dist/utils/fs.js.map

@@ -1 +1 @@
-{"version":3,"file":"fs.js","sourceRoot":"","sources":["../../src/utils/fs.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,MAAM,MAAM,CAAC;AACrC,OAAO,EAAE,SAAS,EAAE,MAAM,cAAc,CAAC;AAOzC;;;GAGG;AACH,MAAM,UAAU,WAAW,CAAC,WAAmB,EAAE,QAAgB;IAC/D,MAAM,GAAG,GAAG,SAAS,EAAE,CAAC;IACxB,MAAM,aAAa,GAAG,GAAG,CAAC,aAAa,CAAC;IAExC,MAAM,QAAQ,GAAG,OAAO,CAAC,IAAI,CAAC,aAAa,EAAE,WAAW,CAAC,EAAE,QAAQ,CAAC,CAAC;IAErE,IAAI,CAAC,QAAQ,CAAC,UAAU,CAAC,aAAa,CAAC,EAAE,CAAC;QACxC,MAAM,GAAG,GAAG,IAAI,KAAK,CACnB,6BAA6B,QAAQ,mCAAmC,CAChD,CAAC;QAC3B,GAAG,CAAC,IAAI,GAAG,yBAAyB,CAAC;QACrC,MAAM,GAAG,CAAC;IACZ,CAAC;IAED,OAAO,EAAE,QAAQ,EAAE,QAAQ,EAAE,QAAQ,EAAE,CAAC;AAC1C,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,oBAAoB,CAAC,GAAG,KAAe;IACrD,MAAM,GAAG,GAAG,SAAS,EAAE,CAAC;IACxB,MAAM,aAAa,GAAG,GAAG,CAAC,aAAa,CAAC;IACxC,MAAM,QAAQ,GAAG,OAAO,CAAC,aAAa,EAAE,GAAG,KAAK,CAAC,CAAC;IAElD,IAAI,CAAC,QAAQ,CAAC,UAAU,CAAC,aAAa,CAAC,EAAE,CAAC;QACxC,MAAM,GAAG,GAAG,IAAI,KAAK,CACnB,+DAA+D,CACvC,CAAC;QAC3B,GAAG,CAAC,IAAI,GAAG,yBAAyB,CAAC;QACrC,MAAM,GAAG,CAAC;IACZ,CAAC;IAED,OAAO,QAAQ,CAAC;AAClB,CAAC"}
+{"version":3,"file":"fs.js","sourceRoot":"","sources":["../../src/utils/fs.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,MAAM,MAAM,CAAC;AACrC,OAAO,EAAE,QAAQ,EAAE,MAAM,aAAa,CAAC;AACvC,OAAO,EAAE,SAAS,EAAE,MAAM,cAAc,CAAC;AAOzC;;;GAGG;AACH,MAAM,UAAU,WAAW,CAAC,WAAmB,EAAE,QAAgB;IAC/D,MAAM,GAAG,GAAG,SAAS,EAAE,CAAC;IACxB,MAAM,aAAa,GAAG,GAAG,CAAC,aAAa,CAAC;IAExC,MAAM,QAAQ,GAAG,OAAO,CAAC,IAAI,CAAC,aAAa,EAAE,WAAW,CAAC,EAAE,QAAQ,CAAC,CAAC;IAErE,IAAI,CAAC,QAAQ,CAAC,UAAU,CAAC,aAAa,CAAC,EAAE,CAAC;QACxC,MAAM,GAAG,GAAG,IAAI,KAAK,CACnB,6BAA6B,QAAQ,mCAAmC,CAChD,CAAC;QAC3B,GAAG,CAAC,IAAI,GAAG,yBAAyB,CAAC;QACrC,MAAM,GAAG,CAAC;IACZ,CAAC;IAED,OAAO,EAAE,QAAQ,EAAE,QAAQ,EAAE,QAAQ,EAAE,CAAC;AAC1C,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,oBAAoB,CAAC,GAAG,KAAe;IACrD,MAAM,GAAG,GAAG,SAAS,EAAE,CAAC;IACxB,MAAM,aAAa,GAAG,GAAG,CAAC,aAAa,CAAC;IACxC,MAAM,QAAQ,GAAG,OAAO,CAAC,aAAa,EAAE,GAAG,KAAK,CAAC,CAAC;IAElD,IAAI,CAAC,QAAQ,CAAC,UAAU,CAAC,aAAa,CAAC,EAAE,CAAC;QACxC,MAAM,GAAG,GAAG,IAAI,KAAK,CACnB,+DAA+D,CACvC,CAAC;QAC3B,GAAG,CAAC,IAAI,GAAG,yBAAyB,CAAC;QACrC,MAAM,GAAG,CAAC;IACZ,CAAC;IAED,OAAO,QAAQ,CAAC;AAClB,CAAC;AAED;;;GAGG;AACH,MAAM,CAAC,KAAK,UAAU,UAAU,CAAC,QAAgB;IAC/C,MAAM,UAAU,GAAG,QAAQ,GAAG,MAAM,CAAC;IACrC,IAAI,CAAC;QACH,MAAM,QAAQ,CAAC,QAAQ,EAAE,UAAU,CAAC,CAAC;QACrC,OAAO,UAAU,CAAC;IACpB,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,IAAI,CAAC;IACd,CAAC;AACH,CAAC"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "workday-studio-mcp-server",
-  "version": "2.0.1",
+  "version": "2.0.2",
   "description": "Enterprise-grade MCP server connecting AI assistants to local Workday Studio / Eclipse workspaces. Runs purely over stdio for local desktop client integration.",
   "type": "module",
   "license": "MIT",