@hamak/smart-data-dico 1.12.2 → 1.12.3

package/backend/dist/server.mjs

@@ -24921,7 +24921,7 @@ var require_main = __commonJS({
       }
     }
     __name(configDotenv, "configDotenv");
-    function config3(options2) {
+    function config4(options2) {
       if (_dotenvKey(options2).length === 0) {
         return DotenvModule.configDotenv(options2);
       }
@@ -24932,7 +24932,7 @@ var require_main = __commonJS({
       }
       return DotenvModule._configVault(options2);
     }
-    __name(config3, "config");
+    __name(config4, "config");
     function decrypt(encrypted, keyStr) {
       const key = Buffer.from(keyStr.slice(-64), "hex");
       let ciphertext = Buffer.from(encrypted, "base64");
@@ -24991,7 +24991,7 @@ var require_main = __commonJS({
       configDotenv,
       _configVault,
       _parseVault,
-      config: config3,
+      config: config4,
       decrypt,
       parse: parse6,
       populate
@@ -37657,13 +37657,15 @@ function normalizeRelationshipEnds(rel) {
       entity: rel.source.entity,
       cardinality: rel.source.cardinality,
       role: rel.source.name,
-      referenceAttributes: rel.source.referenceAttributes
+      referenceAttributes: rel.source.referenceAttributes,
+      stereotype: rel.source.stereotype
     },
     {
       entity: rel.target.entity,
       cardinality: rel.target.cardinality,
       role: rel.target.name,
-      referenceAttributes: rel.target.referenceAttributes
+      referenceAttributes: rel.target.referenceAttributes,
+      stereotype: rel.target.stereotype
     }
   ];
 }
@@ -37675,8 +37677,8 @@ function normalizeRelationship(rel) {
   return {
     ...rel,
     ends: hasEnds ? rel.ends : [a, b],
-    source: rel.source ?? { entity: a.entity, cardinality: a.cardinality, name: a.role, referenceAttributes: a.referenceAttributes },
-    target: rel.target ?? { entity: b.entity, cardinality: b.cardinality, name: b.role, referenceAttributes: b.referenceAttributes }
+    source: rel.source ?? { entity: a.entity, cardinality: a.cardinality, name: a.role, referenceAttributes: a.referenceAttributes, stereotype: a.stereotype },
+    target: rel.target ?? { entity: b.entity, cardinality: b.cardinality, name: b.role, referenceAttributes: b.referenceAttributes, stereotype: b.stereotype }
   };
 }
 function validateEntity(entity) {
@@ -37830,7 +37832,8 @@ var init_EntitySchema = __esm({
             entity: { type: "string" },
             cardinality: { type: "string", enum: Object.values(Cardinality) },
             name: { type: "string" },
-            referenceAttributes: { type: "array", items: { type: "string" } }
+            referenceAttributes: { type: "array", items: { type: "string" } },
+            stereotype: { type: "string" }
           }
         },
         target: {
@@ -37840,7 +37843,8 @@ var init_EntitySchema = __esm({
             entity: { type: "string" },
             cardinality: { type: "string", enum: Object.values(Cardinality) },
             name: { type: "string" },
-            referenceAttributes: { type: "array", items: { type: "string" } }
+            referenceAttributes: { type: "array", items: { type: "string" } },
+            stereotype: { type: "string" }
           }
         },
         metadata: { type: "array" }
@@ -37853,13 +37857,14 @@ var init_EntitySchema = __esm({
 
 // backend/src/kernel/config.ts
 import path from "path";
-var import_dotenv, isProduction, _dataDir, config;
+var import_dotenv, isProduction, AI_MAX_STEPS, _dataDir, config;
 var init_config = __esm({
   "backend/src/kernel/config.ts"() {
     "use strict";
     import_dotenv = __toESM(require_main(), 1);
     import_dotenv.default.config();
     isProduction = process.env.NODE_ENV === "production";
+    AI_MAX_STEPS = 500;
     _dataDir = process.env.DATA_DIR || (isProduction ? path.join(process.cwd(), "data-dictionaries") : path.join(process.cwd(), "..", "samples", "eshop"));
     config = {
       /** Server port */
@@ -38702,11 +38707,11 @@ var require_dist3 = __commonJS({
     exports.createDeferred = exports.deferred = void 0;
     function deferred2() {
       let done;
-      let fail2;
+      let fail3;
       let status = "pending";
       const promise2 = new Promise((_done, _fail) => {
         done = _done;
-        fail2 = _fail;
+        fail3 = _fail;
       });
       return {
         promise: promise2,
@@ -38719,7 +38724,7 @@ var require_dist3 = __commonJS({
         fail(error48) {
           if (status === "pending") {
             status = "rejected";
-            fail2(error48);
+            fail3(error48);
           }
         },
         get fulfilled() {
@@ -38891,13 +38896,13 @@ function useMatchesDefault() {
 }
 function createInstanceConfig(...options2) {
   const baseDir = process.cwd();
-  const config3 = Object.assign(
+  const config4 = Object.assign(
     { baseDir, ...defaultOptions },
     ...options2.filter((o) => typeof o === "object" && o)
   );
-  config3.baseDir = config3.baseDir || baseDir;
-  config3.trimmed = config3.trimmed === true;
-  return config3;
+  config4.baseDir = config4.baseDir || baseDir;
+  config4.trimmed = config4.trimmed === true;
+  return config4;
 }
 function appendTaskOptions(options2, commands = []) {
   if (!filterPlainObject(options2)) {
@@ -39109,11 +39114,11 @@ function isInteractiveMode(option) {
   return option === "--interactive";
 }
 function configListParser(text2) {
-  const config3 = new ConfigList();
+  const config4 = new ConfigList();
   for (const item of configParser(text2)) {
-    config3.addValue(item.file, String(item.key), item.value);
+    config4.addValue(item.file, String(item.key), item.value);
   }
-  return config3;
+  return config4;
 }
 function configGetParser(text2, key) {
   let value = null;
@@ -39917,11 +39922,11 @@ function version_default() {
         commands: ["--version"],
         format: "utf-8",
         parser: versionParser,
-        onError(result, error48, done, fail2) {
+        onError(result, error48, done, fail3) {
           if (result.exitCode === -2) {
             return done(Buffer.from(NOT_INSTALLED));
           }
-          fail2(error48);
+          fail3(error48);
         }
       });
     }
@@ -40026,9 +40031,9 @@ function deleteBranchesTask(branches, forceDelete = false) {
     parser(stdOut, stdErr) {
       return parseBranchDeletions(stdOut, stdErr);
     },
-    onError({ exitCode, stdOut }, error48, done, fail2) {
+    onError({ exitCode, stdOut }, error48, done, fail3) {
       if (!hasBranchDeletionError(String(error48), exitCode)) {
-        return fail2(error48);
+        return fail3(error48);
       }
       done(stdOut);
     }
@@ -40041,9 +40046,9 @@ function deleteBranchTask(branch, forceDelete = false) {
     parser(stdOut, stdErr) {
       return parseBranchDeletions(stdOut, stdErr).branches[branch];
     },
-    onError({ exitCode, stdErr, stdOut }, error48, _, fail2) {
+    onError({ exitCode, stdErr, stdOut }, error48, _, fail3) {
       if (!hasBranchDeletionError(String(error48), exitCode)) {
-        return fail2(error48);
+        return fail3(error48);
       }
       throw new GitResponseError(
         task.parser(bufferToString(stdOut), bufferToString(stdErr)),
@@ -40114,15 +40119,15 @@ function pullTask(remote, branch, customArgs) {
     parser(stdOut, stdErr) {
       return parsePullResult(stdOut, stdErr);
     },
-    onError(result, _error, _done, fail2) {
+    onError(result, _error, _done, fail3) {
       const pullError = parsePullErrorResult(
         bufferToString(result.stdOut),
         bufferToString(result.stdErr)
       );
       if (pullError) {
-        return fail2(new GitResponseError(pullError));
+        return fail3(new GitResponseError(pullError));
       }
-      fail2(_error);
+      fail3(_error);
     }
   };
 }
@@ -40293,8 +40298,8 @@ function isCloneUploadPackSwitch(char, arg) {
   const cleaned = arg.trim().replace(/\0/g, "");
   return /^(--no)?-{1,2}[\dlsqvnobucj]+(\s|$)/.test(cleaned);
 }
-function preventConfigBuilder(config3, setting, message = String(config3)) {
-  const regex = typeof config3 === "string" ? new RegExp(`\\s*${config3}`, "i") : config3;
+function preventConfigBuilder(config4, setting, message = String(config4)) {
+  const regex = typeof config4 === "string" ? new RegExp(`\\s*${config4}`, "i") : config4;
   return /* @__PURE__ */ __name(function preventCommand(options2, arg, next) {
     if (options2[setting] !== true && isConfigSwitch(arg) && regex.test(next)) {
       throw new GitPluginError(
@@ -40439,15 +40444,15 @@ function toBinaryConfig(input, allowUnsafe) {
   };
 }
 function customBinaryPlugin(plugins, input = ["git"], allowUnsafe = false) {
-  let config3 = toBinaryConfig(asArray(input), allowUnsafe);
+  let config4 = toBinaryConfig(asArray(input), allowUnsafe);
   plugins.on("binary", (input2) => {
-    config3 = toBinaryConfig(asArray(input2), allowUnsafe);
+    config4 = toBinaryConfig(asArray(input2), allowUnsafe);
   });
   plugins.append("spawn.binary", () => {
-    return config3.binary;
+    return config4.binary;
   });
   plugins.append("spawn.args", (data) => {
-    return config3.prefix ? [config3.prefix, ...data] : data;
+    return config4.prefix ? [config4.prefix, ...data] : data;
   });
 }
 function isTaskError(result) {
@@ -40464,11 +40469,11 @@ function errorDetectionHandler(overwrite = false, isError = isTaskError, errorMe
     return errorMessage(result);
   };
 }
-function errorDetectionPlugin(config3) {
+function errorDetectionPlugin(config4) {
   return {
     type: "task.error",
     action(data, context2) {
-      const error48 = config3(data.error, {
+      const error48 = config4(data.error, {
         stdErr: context2.stdErr,
         stdOut: context2.stdOut,
         exitCode: context2.exitCode
@@ -40596,30 +40601,30 @@ function suffixPathsPlugin() {
 }
 function gitInstanceFactory(baseDir, options2) {
   const plugins = new PluginStore();
-  const config3 = createInstanceConfig(
+  const config4 = createInstanceConfig(
     baseDir && (typeof baseDir === "string" ? { baseDir } : baseDir) || {},
     options2
   );
-  if (!folderExists(config3.baseDir)) {
+  if (!folderExists(config4.baseDir)) {
     throw new GitConstructError(
-      config3,
+      config4,
       `Cannot use simple-git on a directory that does not exist`
     );
   }
-  if (Array.isArray(config3.config)) {
-    plugins.add(commandConfigPrefixingPlugin(config3.config));
+  if (Array.isArray(config4.config)) {
+    plugins.add(commandConfigPrefixingPlugin(config4.config));
   }
-  plugins.add(blockUnsafeOperationsPlugin(config3.unsafe));
-  plugins.add(completionDetectionPlugin(config3.completion));
-  config3.abort && plugins.add(abortPlugin(config3.abort));
-  config3.progress && plugins.add(progressMonitorPlugin(config3.progress));
-  config3.timeout && plugins.add(timeoutPlugin(config3.timeout));
-  config3.spawnOptions && plugins.add(spawnOptionsPlugin(config3.spawnOptions));
+  plugins.add(blockUnsafeOperationsPlugin(config4.unsafe));
+  plugins.add(completionDetectionPlugin(config4.completion));
+  config4.abort && plugins.add(abortPlugin(config4.abort));
+  config4.progress && plugins.add(progressMonitorPlugin(config4.progress));
+  config4.timeout && plugins.add(timeoutPlugin(config4.timeout));
+  config4.spawnOptions && plugins.add(spawnOptionsPlugin(config4.spawnOptions));
   plugins.add(suffixPathsPlugin());
   plugins.add(errorDetectionPlugin(errorDetectionHandler(true)));
-  config3.errors && plugins.add(errorDetectionPlugin(config3.errors));
-  customBinaryPlugin(plugins, config3.binary, config3.unsafe?.allowUnsafeCustomBinary);
-  return new Git(config3, plugins);
+  config4.errors && plugins.add(errorDetectionPlugin(config4.errors));
+  customBinaryPlugin(plugins, config4.binary, config4.unsafe?.allowUnsafeCustomBinary);
+  return new Git(config4, plugins);
 }
 var import_file_exists, import_debug, import_promise_deferred, import_promise_deferred2, __defProp2, __getOwnPropDesc2, __getOwnPropNames2, __hasOwnProp2, __esm2, __commonJS2, __export2, __copyProps2, __toCommonJS, cache, init_pathspec, GitError, init_git_error, GitResponseError, init_git_response_error, TaskConfigurationError, init_task_configuration_error, NULL, NOOP, objectToString, init_util, filterArray, filterNumber, filterString, filterStringOrStringArray, filterHasLength, init_argument_filters, ExitCodes, init_exit_codes, GitOutputStreams, init_git_output_streams, LineParser, RemoteLineParser, init_line_parser, defaultOptions, init_simple_git_options, init_task_options, init_task_parser, utils_exports, init_utils, check_is_repo_exports, CheckRepoActions, onError, parser, init_check_is_repo, CleanResponse, removalRegexp, dryRunRemovalRegexp, isFolderRegexp, init_CleanSummary, task_exports, EMPTY_COMMANDS, init_task, clean_exports, CONFIG_ERROR_INTERACTIVE_MODE, CONFIG_ERROR_MODE_REQUIRED, CONFIG_ERROR_UNKNOWN_OPTION, CleanOptions, CleanOptionValues, init_clean, ConfigList, init_ConfigList, GitConfigScope, init_config2, DiffNameStatus, diffNameStatus, init_diff_name_status, disallowedOptions, Query, _a, GrepQuery, init_grep, reset_exports, ResetMode, validResetModes, init_reset, init_git_logger, TasksPendingQueue, init_tasks_pending_queue, GitExecutorChain, init_git_executor_chain, git_executor_exports, GitExecutor, init_git_executor, init_task_callback, init_change_working_directory, init_checkout, parser2, init_count_objects, parsers, init_parse_commit, init_commit, init_first_commit, init_hash_object, InitSummary, initResponseRegex, reInitResponseRegex, init_InitSummary, bareCommand, init_init, logFormatRegex, init_log_format, DiffSummary, init_DiffSummary, statParser, numStatParser, nameOnlyParser, nameStatusParser, diffSummaryParsers, init_parse_diff_summary, START_BOUNDARY, COMMIT_BOUNDARY, SPLITTER, defaultFieldNames, init_parse_list_log_summary, diff_exports, init_diff, excludeOptions, init_log, MergeSummaryConflict, MergeSummaryDetail, init_MergeSummary, PullSummary, PullFailedSummary, init_PullSummary, remoteMessagesObjectParsers, init_parse_remote_objects, parsers2, RemoteMessageSummary, init_parse_remote_messages, FILE_UPDATE_REGEX, SUMMARY_REGEX, ACTION_REGEX, parsers3, errorParsers, parsePullDetail, parsePullResult, init_parse_pull, parsers4, parseMergeResult, parseMergeDetail, init_parse_merge, init_merge, parsers5, parsePushResult, parsePushDetail, init_parse_push, push_exports, init_push, init_show, fromPathRegex, FileStatusSummary, init_FileStatusSummary, StatusSummary, parsers6, parseStatusSummary, init_StatusSummary, ignoredOptions, init_status, NOT_INSTALLED, parsers7, init_version, cloneTask, cloneMirrorTask, init_clone, simple_git_api_exports, SimpleGitApi, init_simple_git_api, scheduler_exports, createScheduledTask, Scheduler, init_scheduler, apply_patch_exports, init_apply_patch, BranchDeletionBatch, init_BranchDeleteSummary, deleteSuccessRegex, deleteErrorRegex, parsers8, parseBranchDeletions, init_parse_branch_delete, BranchSummaryResult, init_BranchSummary, parsers9, currentBranchParser, init_parse_branch, branch_exports, init_branch, parseCheckIgnore, init_CheckIgnore, check_ignore_exports, init_check_ignore, parsers10, init_parse_fetch, fetch_exports, init_fetch, parsers11, init_parse_move, move_exports, init_move, pull_exports, init_pull, init_GetRemoteSummary, remote_exports, init_remote, stash_list_exports, init_stash_list, sub_module_exports, init_sub_module, TagList, parseTagList, init_TagList, tag_exports, init_tag, require_git, GitConstructError, GitPluginError, preventUnsafeConfig, never, WRONG_NUMBER_ERR, WRONG_CHARS_ERR, PluginStore, Git, esm_default;
 var init_esm = __esm({
@@ -40961,11 +40966,11 @@ var init_esm = __esm({
           CheckRepoActions2["IS_REPO_ROOT"] = "root";
           return CheckRepoActions2;
         })(CheckRepoActions || {});
-        onError = /* @__PURE__ */ __name(({ exitCode }, error48, done, fail2) => {
+        onError = /* @__PURE__ */ __name(({ exitCode }, error48, done, fail3) => {
           if (exitCode === 128 && isNotRepoMessage(error48)) {
             return done(Buffer.from("false"));
           }
-          fail2(error48);
+          fail3(error48);
         }, "onError");
         parser = /* @__PURE__ */ __name((text2) => {
           return text2.trim() === "true";
@@ -41376,7 +41381,7 @@ var init_esm = __esm({
           }
           handleTaskData(task, args, result, logger2) {
             const { exitCode, rejection, stdOut, stdErr } = result;
-            return new Promise((done, fail2) => {
+            return new Promise((done, fail3) => {
               logger2(`Preparing to handle process response exitCode=%d stdOut=`, exitCode);
               const { error: error48 } = this._plugins.exec(
                 "task.error",
@@ -41401,7 +41406,7 @@ var init_esm = __esm({
                       )
                     );
                   },
-                  fail2
+                  fail3
                 );
               }
               if (error48) {
@@ -41411,7 +41416,7 @@ var init_esm = __esm({
                   stdErr.length,
                   rejection
                 );
-                return fail2(error48);
+                return fail3(error48);
               }
               logger2.info(`retrieving task output complete`);
               done(new GitOutputStreams(Buffer.concat(stdOut), Buffer.concat(stdErr)));
@@ -43375,9 +43380,9 @@ var init_esm = __esm({
       static {
         __name(this, "GitConstructError");
       }
-      constructor(config3, message) {
+      constructor(config4, message) {
         super(void 0, message);
-        this.config = config3;
+        this.config = config4;
       }
     };
     init_git_error();
@@ -43791,8 +43796,8 @@ var init_git_service = __esm({
 });
 
 // backend/node_modules/@hamak/ui-remote-git-fs-backend/dist/routes/git-routes.js
-function createGitRoutes(config3) {
-  const { gitService, debug: debug2 } = config3;
+function createGitRoutes(config4) {
+  const { gitService, debug: debug2 } = config4;
   const router28 = (0, import_express2.Router)();
   const log2 = /* @__PURE__ */ __name((message, ...args) => {
     if (debug2) {
@@ -43961,8 +43966,8 @@ var init_git_routes = __esm({
 
 // backend/node_modules/@hamak/ui-remote-git-fs-backend/dist/enrichers/git-file-info-enricher.js
 import path3 from "path";
-function createGitFileInfoEnricher(config3) {
-  return new GitFileInfoEnricher(config3);
+function createGitFileInfoEnricher(config4) {
+  return new GitFileInfoEnricher(config4);
 }
 var GitFileInfoEnricher;
 var init_git_file_info_enricher = __esm({
@@ -43971,13 +43976,13 @@ var init_git_file_info_enricher = __esm({
       static {
         __name(this, "GitFileInfoEnricher");
       }
-      constructor(config3) {
+      constructor(config4) {
         this.extensionKey = "git";
         this.priority = 50;
         this.statusCache = /* @__PURE__ */ new Map();
         this.cacheTimeout = 5e3;
-        this.gitService = config3.gitService;
-        this.workspaceRoots = config3.workspaceRoots;
+        this.gitService = config4.gitService;
+        this.workspaceRoots = config4.workspaceRoots;
       }
       /**
        * Check if git enrichment is requested
@@ -47035,7 +47040,7 @@ var init_caseService = __esm({
         }
         const visitedEntities = /* @__PURE__ */ new Set();
         while (queue.length > 0) {
-          const { entityUuid, hopDistance, pathSegments, usedRelationships, inboundNav } = queue.shift();
+          const { entityUuid, hopDistance, pathSegments, usedRelationships, inboundNav, inboundIsComposition, inboundIsManual } = queue.shift();
           if (visitedEntities.has(entityUuid)) continue;
           visitedEntities.add(entityUuid);
           const currentPath = pathSegments.join("/");
@@ -47053,7 +47058,8 @@ var init_caseService = __esm({
             hopDistance,
             isRoot: hopDistance === 0,
             isFrontier,
-            isManualInclusion: false,
+            isManualInclusion: inboundIsManual === true,
+            isComposition: hopDistance === 0 ? void 0 : inboundIsComposition === true,
             attributes: info.attributes,
             metadata: info.metadata.length > 0 ? info.metadata : void 0
           };
@@ -47067,23 +47073,54 @@ var init_caseService = __esm({
           resolvedNodes.push(resolved);
           if (isFrontier) continue;
           const neighbors = adjacency.get(entityUuid) || [];
-          for (const { neighborUuid, navName, relationshipUuid, fromCard, toCard } of neighbors) {
+          const byNeighbor = /* @__PURE__ */ new Map();
+          for (const edge of neighbors) {
+            if (!byNeighbor.has(edge.neighborUuid)) byNeighbor.set(edge.neighborUuid, []);
+            byNeighbor.get(edge.neighborUuid).push(edge);
+          }
+          for (const [neighborUuid, parallelEdges] of byNeighbor) {
             if (visitedEntities.has(neighborUuid)) continue;
-            if (usedRelationships.has(relationshipUuid)) continue;
+            const edges = parallelEdges.filter((e) => !usedRelationships.has(e.relationshipUuid));
+            if (edges.length === 0) continue;
             const neighborInfo = entityMap.get(neighborUuid);
             if (!neighborInfo) continue;
             const newPath = [...pathSegments, neighborInfo.name];
             const newPathStr = newPath.join("/");
             const prefixNode = nodesByPath.get(newPathStr);
             if (prefixNode?.exclude) continue;
+            const edge = edges.find((e) => e.isComposition) ?? edges.find((e) => e.navName) ?? edges[0];
+            const isComposition = edge.isComposition;
+            const cross = prefixNode?.traverse ?? isComposition;
+            if (!cross) {
+              resolvedNodes.push({
+                entityUuid: neighborUuid,
+                entityName: neighborInfo.name,
+                service: neighborInfo.service,
+                path: newPathStr,
+                hopDistance: hopDistance + 1,
+                isRoot: false,
+                isFrontier: true,
+                isManualInclusion: false,
+                isComposition,
+                isExpandable: true,
+                navName: edge.navName,
+                navCardinality: { from: edge.fromCard, to: edge.toCard },
+                attributes: neighborInfo.attributes,
+                metadata: neighborInfo.metadata.length > 0 ? neighborInfo.metadata : void 0
+              });
+              continue;
+            }
             const newUsed = new Set(usedRelationships);
-            newUsed.add(relationshipUuid);
+            newUsed.add(edge.relationshipUuid);
             queue.push({
               entityUuid: neighborUuid,
               hopDistance: hopDistance + 1,
               pathSegments: newPath,
               usedRelationships: newUsed,
-              inboundNav: { navName, fromCard, toCard }
+              inboundNav: { navName: edge.navName, fromCard: edge.fromCard, toCard: edge.toCard },
+              inboundIsComposition: isComposition,
+              // Manual inclusion = the user force-expanded a non-composition edge.
+              inboundIsManual: prefixNode?.traverse === true && !isComposition
             });
           }
         }
@@ -47160,16 +47197,18 @@ var init_caseService = __esm({
         for (const { relationships } of allRels) {
           for (const rel of relationships) {
             const [endA, endB] = normalizeRelationshipEnds(rel);
-            const fallback = rel.description || rel.uuid;
-            const roleA = endA.role || fallback;
-            const roleB = endB.role || fallback;
+            const roleA = endA.role;
+            const roleB = endB.role;
+            const aIsOwner = endA.stereotype === "composition";
+            const bIsOwner = endB.stereotype === "composition";
             if (!adjacency.has(endA.entity)) adjacency.set(endA.entity, []);
             adjacency.get(endA.entity).push({
               neighborUuid: endB.entity,
               navName: roleA,
               relationshipUuid: rel.uuid,
               fromCard: endA.cardinality,
-              toCard: endB.cardinality
+              toCard: endB.cardinality,
+              isComposition: aIsOwner
             });
             if (!adjacency.has(endB.entity)) adjacency.set(endB.entity, []);
             adjacency.get(endB.entity).push({
@@ -47177,7 +47216,8 @@ var init_caseService = __esm({
               navName: roleB,
               relationshipUuid: rel.uuid,
               fromCard: endB.cardinality,
-              toCard: endA.cardinality
+              toCard: endA.cardinality,
+              isComposition: bIsOwner
             });
           }
         }
@@ -47976,6 +48016,155 @@ var init_serviceService = __esm({
   }
 });
 
+// backend/src/services/dicoConfigService.ts
+async function readConfig() {
+  try {
+    const raw = await storageRegistry.getBackend().read(DICT_WS2, CONFIG_PATH);
+    const parsed = JSON.parse(raw);
+    if (typeof parsed.version !== "number") parsed.version = 1;
+    return parsed;
+  } catch (e) {
+    if (e.code === "not-found") return { version: 1 };
+    logger.error(`Failed to read dico.config.json: ${e}`);
+    return { version: 1 };
+  }
+}
+async function writeConfig(next) {
+  const body = JSON.stringify(next, null, 2) + "\n";
+  await storageRegistry.getBackend().write(DICT_WS2, CONFIG_PATH, body);
+}
+async function listDerivedTypes() {
+  const cfg = await readConfig();
+  return Array.isArray(cfg.types) ? cfg.types : [];
+}
+async function replaceDerivedTypes(next) {
+  const errors = validateDerivedTypes(next);
+  if (errors.length > 0) return { success: false, errors };
+  const cfg = await readConfig();
+  cfg.types = next;
+  await writeConfig(cfg);
+  return { success: true };
+}
+function validateDerivedTypes(types) {
+  const errors = [];
+  const byName = /* @__PURE__ */ new Map();
+  for (const t of types) {
+    if (!t?.name || typeof t.name !== "string") {
+      errors.push("Each derived type must have a `name` string");
+      continue;
+    }
+    if (STANDARD_TYPES.has(t.name)) {
+      errors.push(`Derived type name '${t.name}' shadows a standard AttributeType`);
+    }
+    if (byName.has(t.name)) {
+      errors.push(`Duplicate derived type name: '${t.name}'`);
+    } else {
+      byName.set(t.name, t);
+    }
+    if (!t.basedOn || typeof t.basedOn !== "string") {
+      errors.push(`Derived type '${t.name}' must declare a \`basedOn\``);
+    }
+    if (t.domain) errors.push(...validateDomain(t.name, t.domain));
+  }
+  for (const t of types) {
+    if (!t?.name || !t?.basedOn) continue;
+    const visited = /* @__PURE__ */ new Set();
+    let cursor = t.basedOn;
+    while (cursor && !STANDARD_TYPES.has(cursor)) {
+      if (visited.has(cursor)) {
+        errors.push(`Circular derivation starting at '${t.name}' (cycle via '${cursor}')`);
+        break;
+      }
+      visited.add(cursor);
+      const next = byName.get(cursor);
+      if (!next) {
+        errors.push(`Derived type '${t.name}' references unknown type '${cursor}'`);
+        break;
+      }
+      cursor = next.basedOn;
+    }
+  }
+  return errors;
+}
+function validateDomain(typeName, domain2) {
+  const errors = [];
+  if (!DOMAIN_KINDS.has(domain2.kind)) {
+    errors.push(`Derived type '${typeName}' has invalid domain kind '${domain2.kind}'`);
+    return errors;
+  }
+  const hasValues = Array.isArray(domain2.values) && domain2.values.length > 0;
+  const hasSource = typeof domain2.source === "string" && domain2.source.trim().length > 0;
+  if (domain2.kind === "enum") {
+    if (!hasValues) errors.push(`Enum domain '${typeName}' must list at least one value`);
+    if (hasSource) errors.push(`Enum domain '${typeName}' must not declare a \`source\``);
+  } else if (domain2.kind === "codelist") {
+    if (!hasSource) errors.push(`Codelist domain '${typeName}' must declare a \`source\` name`);
+  } else if (domain2.kind === "reference") {
+    if (!hasSource) errors.push(`Reference domain '${typeName}' must declare a \`source\` name`);
+    if (hasValues) errors.push(`Reference domain '${typeName}' must not carry inline \`values\` (they come from the source)`);
+  }
+  return errors;
+}
+function resolveDomain(typeName, derivedTypes) {
+  if (STANDARD_TYPES.has(typeName)) return null;
+  const byName = new Map(derivedTypes.map((t) => [t.name, t]));
+  const visited = /* @__PURE__ */ new Set();
+  let cursor = typeName;
+  while (!STANDARD_TYPES.has(cursor)) {
+    if (visited.has(cursor)) return null;
+    visited.add(cursor);
+    const dt = byName.get(cursor);
+    if (!dt) return null;
+    if (dt.domain) return dt.domain;
+    cursor = dt.basedOn;
+  }
+  return null;
+}
+function resolveAttributeType(typeName, derivedTypes) {
+  if (STANDARD_TYPES.has(typeName)) {
+    return { baseType: typeName, validation: {} };
+  }
+  const byName = new Map(derivedTypes.map((t) => [t.name, t]));
+  const chain = [];
+  const visited = /* @__PURE__ */ new Set();
+  let cursor = typeName;
+  while (!STANDARD_TYPES.has(cursor)) {
+    if (visited.has(cursor)) return null;
+    visited.add(cursor);
+    const dt = byName.get(cursor);
+    if (!dt) return null;
+    chain.push(dt);
+    cursor = dt.basedOn;
+  }
+  const merged = {};
+  for (let i = chain.length - 1; i >= 0; i--) {
+    Object.assign(merged, chain[i].validation || {});
+  }
+  return { baseType: cursor, validation: merged };
+}
+var DOMAIN_KINDS, DICT_WS2, CONFIG_PATH, STANDARD_TYPES;
+var init_dicoConfigService = __esm({
+  "backend/src/services/dicoConfigService.ts"() {
+    "use strict";
+    init_EntitySchema();
+    init_logger();
+    init_StorageBackendToken();
+    init_types();
+    DOMAIN_KINDS = /* @__PURE__ */ new Set(["enum", "codelist", "reference"]);
+    DICT_WS2 = wsId("dictionaries");
+    CONFIG_PATH = pathOf("dico.config.json");
+    STANDARD_TYPES = new Set(Object.values(AttributeType));
+    __name(readConfig, "readConfig");
+    __name(writeConfig, "writeConfig");
+    __name(listDerivedTypes, "listDerivedTypes");
+    __name(replaceDerivedTypes, "replaceDerivedTypes");
+    __name(validateDerivedTypes, "validateDerivedTypes");
+    __name(validateDomain, "validateDomain");
+    __name(resolveDomain, "resolveDomain");
+    __name(resolveAttributeType, "resolveAttributeType");
+  }
+});
+
 // backend/src/services/versionService.ts
 var versionService_exports = {};
 __export(versionService_exports, {
@@ -49030,10 +49219,10 @@ function prefixIssues(path14, issues) {
 function unwrapMessage(message) {
   return typeof message === "string" ? message : message?.message;
 }
-function finalizeIssue(iss, ctx, config3) {
+function finalizeIssue(iss, ctx, config4) {
   const full = { ...iss, path: iss.path ?? [] };
   if (!iss.message) {
-    const message = unwrapMessage(iss.inst?._zod.def?.error?.(iss)) ?? unwrapMessage(ctx?.error?.(iss)) ?? unwrapMessage(config3.customError?.(iss)) ?? unwrapMessage(config3.localeError?.(iss)) ?? "Invalid input";
+    const message = unwrapMessage(iss.inst?._zod.def?.error?.(iss)) ?? unwrapMessage(ctx?.error?.(iss)) ?? unwrapMessage(config4.customError?.(iss)) ?? unwrapMessage(config4.localeError?.(iss)) ?? "Invalid input";
     full.message = message;
   }
   delete full.inst;
@@ -70145,13 +70334,13 @@ var require_auth_config = __commonJS({
       }
     }
     __name(readAuthConfig, "readAuthConfig");
-    function writeAuthConfig(config3) {
+    function writeAuthConfig(config4) {
       const authPath = getAuthConfigPath();
       const authDir = path14.dirname(authPath);
       if (!fs6.existsSync(authDir)) {
         fs6.mkdirSync(authDir, { mode: 504, recursive: true });
       }
-      fs6.writeFileSync(authPath, JSON.stringify(config3, null, 2), { mode: 384 });
+      fs6.writeFileSync(authPath, JSON.stringify(config4, null, 2), { mode: 384 });
     }
     __name(writeAuthConfig, "writeAuthConfig");
     function isValidAccessToken(authConfig) {
@@ -71297,8 +71486,8 @@ Run 'npx vercel link' to link your project, then 'vc env pull' to fetch the toke
       static {
         __name(this, "GatewayFetchMetadata");
       }
-      constructor(config3) {
-        this.config = config3;
+      constructor(config4) {
+        this.config = config4;
       }
       async getAvailableModels() {
         try {
@@ -71387,8 +71576,8 @@ Run 'npx vercel link' to link your project, then 'vc env pull' to fetch the toke
       static {
         __name(this, "GatewaySpendReport");
       }
-      constructor(config3) {
-        this.config = config3;
+      constructor(config4) {
+        this.config = config4;
       }
       async getSpendReport(params) {
         try {
@@ -71488,8 +71677,8 @@ Run 'npx vercel link' to link your project, then 'vc env pull' to fetch the toke
       static {
         __name(this, "GatewayGenerationInfoFetcher");
       }
-      constructor(config3) {
-        this.config = config3;
+      constructor(config4) {
+        this.config = config4;
       }
       async getGenerationInfo(params) {
         try {
@@ -71574,9 +71763,9 @@ Run 'npx vercel link' to link your project, then 'vc env pull' to fetch the toke
       static {
         __name(this, "GatewayLanguageModel");
       }
-      constructor(modelId, config3) {
+      constructor(modelId, config4) {
         this.modelId = modelId;
-        this.config = config3;
+        this.config = config4;
         this.specificationVersion = "v3";
         this.supportedUrls = { "*/*": [/.*/] };
       }
@@ -71722,9 +71911,9 @@ Run 'npx vercel link' to link your project, then 'vc env pull' to fetch the toke
       static {
         __name(this, "GatewayEmbeddingModel");
       }
-      constructor(modelId, config3) {
+      constructor(modelId, config4) {
         this.modelId = modelId;
-        this.config = config3;
+        this.config = config4;
         this.specificationVersion = "v3";
         this.maxEmbeddingsPerCall = 2048;
         this.supportsParallelCalls = true;
@@ -71801,9 +71990,9 @@ Run 'npx vercel link' to link your project, then 'vc env pull' to fetch the toke
       static {
         __name(this, "GatewayImageModel");
       }
-      constructor(modelId, config3) {
+      constructor(modelId, config4) {
         this.modelId = modelId;
-        this.config = config3;
+        this.config = config4;
         this.specificationVersion = "v3";
         this.maxImagesPerCall = Number.MAX_SAFE_INTEGER;
       }
@@ -71927,9 +72116,9 @@ Run 'npx vercel link' to link your project, then 'vc env pull' to fetch the toke
       static {
         __name(this, "GatewayVideoModel");
       }
-      constructor(modelId, config3) {
+      constructor(modelId, config4) {
         this.modelId = modelId;
-        this.config = config3;
+        this.config = config4;
         this.specificationVersion = "v3";
         this.maxVideosPerCall = Number.MAX_SAFE_INTEGER;
       }
@@ -72187,7 +72376,7 @@ Run 'npx vercel link' to link your project, then 'vc env pull' to fetch the toke
       inputSchema: parallelSearchInputSchema,
       outputSchema: parallelSearchOutputSchema
     });
-    parallelSearch = /* @__PURE__ */ __name((config3 = {}) => parallelSearchToolFactory(config3), "parallelSearch");
+    parallelSearch = /* @__PURE__ */ __name((config4 = {}) => parallelSearchToolFactory(config4), "parallelSearch");
     perplexitySearchInputSchema = lazySchema(
       () => zodSchema(
         external_exports.object({
@@ -72266,7 +72455,7 @@ Run 'npx vercel link' to link your project, then 'vc env pull' to fetch the toke
       inputSchema: perplexitySearchInputSchema,
       outputSchema: perplexitySearchOutputSchema
     });
-    perplexitySearch = /* @__PURE__ */ __name((config3 = {}) => perplexitySearchToolFactory(config3), "perplexitySearch");
+    perplexitySearch = /* @__PURE__ */ __name((config4 = {}) => perplexitySearchToolFactory(config4), "perplexitySearch");
     gatewayTools = {
       /**
        * Search the web using Parallel AI's Search API for LLM-optimized excerpts.
@@ -81337,9 +81526,9 @@ function readAppConfig() {
   if (!fs.existsSync(CONFIG_FILE) && fs.existsSync(LEGACY_CONFIG)) {
     try {
       const legacy = JSON.parse(fs.readFileSync(LEGACY_CONFIG, "utf8"));
-      const config3 = { ai: legacy };
-      writeConfigFileAtomic(JSON.stringify(config3, null, 2));
-      return config3;
+      const config4 = { ai: legacy };
+      writeConfigFileAtomic(JSON.stringify(config4, null, 2));
+      return config4;
     } catch {
     }
   }
@@ -81359,8 +81548,8 @@ function writeAppConfig(updates) {
   writeConfigFileAtomic(JSON.stringify(merged, null, 2));
 }
 function getConfigSection(section) {
-  const config3 = readAppConfig();
-  return config3[section];
+  const config4 = readAppConfig();
+  return config4[section];
 }
 function setConfigSection(section, value) {
   writeAppConfig({ [section]: value });
@@ -98199,21 +98388,21 @@ var init_client2 = __esm({
        * Handlers are silently skipped if the server doesn't advertise the corresponding listChanged capability.
        * @internal
        */
-      _setupListChangedHandlers(config3) {
-        if (config3.tools && this._serverCapabilities?.tools?.listChanged) {
-          this._setupListChangedHandler("tools", ToolListChangedNotificationSchema, config3.tools, async () => {
+      _setupListChangedHandlers(config4) {
+        if (config4.tools && this._serverCapabilities?.tools?.listChanged) {
+          this._setupListChangedHandler("tools", ToolListChangedNotificationSchema, config4.tools, async () => {
             const result = await this.listTools();
             return result.tools;
           });
         }
-        if (config3.prompts && this._serverCapabilities?.prompts?.listChanged) {
-          this._setupListChangedHandler("prompts", PromptListChangedNotificationSchema, config3.prompts, async () => {
+        if (config4.prompts && this._serverCapabilities?.prompts?.listChanged) {
+          this._setupListChangedHandler("prompts", PromptListChangedNotificationSchema, config4.prompts, async () => {
             const result = await this.listPrompts();
             return result.prompts;
           });
         }
-        if (config3.resources && this._serverCapabilities?.resources?.listChanged) {
-          this._setupListChangedHandler("resources", ResourceListChangedNotificationSchema, config3.resources, async () => {
+        if (config4.resources && this._serverCapabilities?.resources?.listChanged) {
+          this._setupListChangedHandler("resources", ResourceListChangedNotificationSchema, config4.resources, async () => {
             const result = await this.listResources();
             return result.resources;
           });
@@ -101124,6 +101313,443 @@ var init_mcpClientRegistry = __esm({
   }
 });
 
+// backend/src/controllers/aiMutationTools.ts
+function fail2(error48) {
+  return { success: false, error: error48 };
+}
+function cardinalityLabel(c) {
+  return c === "many" /* MANY */ || c === "many" ? "0..*" : "1";
+}
+async function ensurePackage(packageName) {
+  const { listPackages: listPackages2, ensurePackageDirectoryStructure: ensurePackageDirectoryStructure2 } = await Promise.resolve().then(() => (init_fileOperations(), fileOperations_exports));
+  const existing = await listPackages2();
+  if (!existing.includes(packageName)) {
+    await ensurePackageDirectoryStructure2(packageName);
+  }
+}
+async function packageExists(packageName) {
+  const { listPackages: listPackages2 } = await Promise.resolve().then(() => (init_fileOperations(), fileOperations_exports));
+  const existing = await listPackages2();
+  return existing.includes(packageName);
+}
+function buildEntity(input, existing) {
+  const existingByName = new Map((existing?.attributes ?? []).map((a) => [a.name, a]));
+  const attributes = input.attributes.map((a) => {
+    const prior = existingByName.get(a.name);
+    return {
+      uuid: prior?.uuid ?? generateUUID(),
+      name: a.name,
+      type: a.type,
+      description: a.description ?? "",
+      required: a.required ?? false,
+      ...a.primaryKey !== void 0 ? { primaryKey: a.primaryKey } : {},
+      ...a.enumValues ? { validation: { enumValues: a.enumValues } } : {}
+    };
+  });
+  return {
+    uuid: existing?.uuid ?? generateUUID(),
+    name: input.name,
+    description: input.description ?? existing?.description ?? "",
+    ...input.stereotype !== void 0 ? { stereotype: input.stereotype } : existing?.stereotype ? { stereotype: existing.stereotype } : {},
+    status: existing?.status ?? "draft" /* DRAFT */,
+    attributes,
+    createdAt: existing?.createdAt ?? (/* @__PURE__ */ new Date()).toISOString(),
+    updatedAt: (/* @__PURE__ */ new Date()).toISOString()
+  };
+}
+async function validateEntityMutation(input, entity, services, kind) {
+  if (kind === "update" && !await packageExists(input.packageName)) {
+    return { ok: false, error: `Package "${input.packageName}" does not exist.` };
+  }
+  const seen = /* @__PURE__ */ new Set();
+  for (const a of input.attributes) {
+    if (seen.has(a.name)) {
+      return { ok: false, error: `Duplicate attribute name "${a.name}" in entity ${input.name}.` };
+    }
+    seen.add(a.name);
+  }
+  const derivedTypes = await listDerivedTypes();
+  for (const a of input.attributes) {
+    if (resolveAttributeType(a.type, derivedTypes) == null) {
+      return {
+        ok: false,
+        error: `Attribute "${a.name}" has unknown type "${a.type}". Use a standard AttributeType (${Object.values(AttributeType).join(", ")}) or a defined derived type.`
+      };
+    }
+  }
+  if (input.stereotype) {
+    const stereotypes = await services.stereotypeService.getAllStereotypes("entity");
+    const known = stereotypes.some((s) => s.id === input.stereotype || s.name === input.stereotype);
+    if (!known) {
+      const ids = stereotypes.map((s) => s.id).join(", ") || "(none defined)";
+      return { ok: false, error: `Unknown entity stereotype "${input.stereotype}". Known: ${ids}.` };
+    }
+  }
+  if (kind === "create") {
+    const existing = await services.serviceService.getEntitySchema(input.packageName, input.name);
+    if (existing) {
+      return { ok: false, error: `Entity "${input.name}" already exists in package "${input.packageName}".` };
+    }
+  }
+  const schemaResult = validateEntity(entity);
+  if (!schemaResult.valid) {
+    return { ok: false, error: `Entity failed schema validation: ${schemaResult.errors.join("; ")}` };
+  }
+  return { ok: true };
+}
+async function executeCreateEntity(input, services) {
+  try {
+    await ensurePackage(input.packageName);
+    const entity = buildEntity(input);
+    const validation = await validateEntityMutation(input, entity, services, "create");
+    if (!validation.ok) return fail2(validation.error);
+    const result = await services.serviceService.createEntity(input.packageName, entity);
+    if (!result.success) return fail2(result.errors.join("; ") || "Failed to create entity.");
+    const attrCount = entity.attributes.length;
+    const stereoNote = entity.stereotype ? `, stereotype ${entity.stereotype}` : "";
+    const summary = `Created entity ${entity.name} (+${attrCount} attribute${attrCount === 1 ? "" : "s"}${stereoNote})`;
+    return {
+      success: true,
+      changeKind: "created",
+      elementType: "entity",
+      name: entity.name,
+      packageName: input.packageName,
+      summary,
+      navigate: `/packages/${input.packageName}/entities/${entity.name}`,
+      highlight: entity.name,
+      message: summary
+    };
+  } catch (err) {
+    return fail2(err instanceof Error ? err.message : String(err));
+  }
+}
+async function executeUpdateEntity(input, services) {
+  try {
+    const existing = await services.serviceService.getEntitySchema(input.packageName, input.name);
+    if (!existing) {
+      return fail2(`Entity "${input.name}" not found in package "${input.packageName}".`);
+    }
+    const entity = buildEntity(input, existing);
+    const validation = await validateEntityMutation(input, entity, services, "update");
+    if (!validation.ok) return fail2(validation.error);
+    const result = await services.serviceService.updateEntity(input.packageName, entity);
+    if (!result.success) return fail2(result.errors.join("; ") || "Failed to update entity.");
+    const before = existing.attributes.length;
+    const after = entity.attributes.length;
+    const delta = after - before;
+    const deltaNote = delta === 0 ? "attributes unchanged" : delta > 0 ? `+${delta} attribute${delta === 1 ? "" : "s"}` : `-${Math.abs(delta)} attribute${Math.abs(delta) === 1 ? "" : "s"}`;
+    const summary = `Updated ${entity.name} (${deltaNote})`;
+    return {
+      success: true,
+      changeKind: "updated",
+      elementType: "entity",
+      name: entity.name,
+      packageName: input.packageName,
+      summary,
+      navigate: `/packages/${input.packageName}/entities/${entity.name}`,
+      highlight: entity.name,
+      message: summary
+    };
+  } catch (err) {
+    return fail2(err instanceof Error ? err.message : String(err));
+  }
+}
+async function executeDeleteEntity(input, services) {
+  try {
+    const result = await services.serviceService.deleteEntity(input.packageName, input.name);
+    if (!result.success) return fail2(result.errors.join("; ") || "Failed to delete entity.");
+    const summary = `Deleted entity ${input.name}`;
+    return {
+      success: true,
+      changeKind: "deleted",
+      elementType: "entity",
+      name: input.name,
+      packageName: input.packageName,
+      summary,
+      // Deletes navigate to the package page (the entity page no longer exists).
+      navigate: `/packages/${input.packageName}`,
+      message: summary
+    };
+  } catch (err) {
+    return fail2(err instanceof Error ? err.message : String(err));
+  }
+}
+async function resolveRelationshipEnds(sourceEntityName, targetEntityName, sourcePackage, targetPackage, services) {
+  let src;
+  try {
+    src = await services.serviceService.findEntityAcrossPackages(sourceEntityName, sourcePackage);
+  } catch (e) {
+    return fail2(`Source: ${e instanceof Error ? e.message : String(e)}`);
+  }
+  if (!src) return fail2(`Source entity "${sourceEntityName}" not found in any package.`);
+  let tgt;
+  try {
+    tgt = await services.serviceService.findEntityAcrossPackages(targetEntityName, targetPackage);
+  } catch (e) {
+    return fail2(`Target: ${e instanceof Error ? e.message : String(e)}`);
+  }
+  if (!tgt) return fail2(`Target entity "${targetEntityName}" not found in any package.`);
+  return { src, tgt, homePackage: src.packageName };
+}
+function validateRelationshipMutation(relationship) {
+  const result = validateRelationship(relationship);
+  if (!result.valid) {
+    return { ok: false, error: `Relationship failed schema validation: ${result.errors.join("; ")}` };
+  }
+  return { ok: true };
+}
+function relationshipName(sourceName, targetName) {
+  return `${sourceName} \u2192 ${targetName}`;
+}
+async function executeCreateRelationship(input, services) {
+  try {
+    const ends = await resolveRelationshipEnds(
+      input.sourceEntityName,
+      input.targetEntityName,
+      input.sourcePackage,
+      input.targetPackage,
+      services
+    );
+    if ("success" in ends) return ends;
+    const relationship = {
+      uuid: generateUUID(),
+      description: input.description ?? "",
+      source: { entity: ends.src.entity.uuid, cardinality: input.sourceCardinality },
+      target: { entity: ends.tgt.entity.uuid, cardinality: input.targetCardinality }
+    };
+    const validation = validateRelationshipMutation(relationship);
+    if (!validation.ok) return fail2(validation.error);
+    const result = await services.serviceService.createRelationship(ends.homePackage, relationship);
+    if (!result.success) return fail2(result.errors.join("; ") || "Failed to create relationship.");
+    const name21 = relationshipName(input.sourceEntityName, input.targetEntityName);
+    const crossNote = ends.src.packageName !== ends.tgt.packageName ? `, cross-package ${ends.src.packageName} \u2192 ${ends.tgt.packageName}` : "";
+    const summary = `Created relationship ${name21} (${cardinalityLabel(input.sourceCardinality)} \u2192 ${cardinalityLabel(input.targetCardinality)}${crossNote})`;
+    return {
+      success: true,
+      changeKind: "created",
+      elementType: "relationship",
+      name: name21,
+      packageName: ends.homePackage,
+      summary,
+      message: summary
+    };
+  } catch (err) {
+    return fail2(err instanceof Error ? err.message : String(err));
+  }
+}
+async function findRelationshipUuid(homePackage, srcUuid, tgtUuid, sourceName, targetName, services) {
+  const rels = await services.serviceService.getPackageRelationships(homePackage);
+  const match = rels.find((r) => r.source?.entity === srcUuid && r.target?.entity === tgtUuid);
+  if (!match) {
+    return fail2(`No relationship ${relationshipName(sourceName, targetName)} found in package "${homePackage}".`);
+  }
+  return match.uuid;
+}
+async function executeUpdateRelationship(input, services) {
+  try {
+    const ends = await resolveRelationshipEnds(
+      input.sourceEntityName,
+      input.targetEntityName,
+      input.sourcePackage,
+      input.targetPackage,
+      services
+    );
+    if ("success" in ends) return ends;
+    const uuidOrFail = await findRelationshipUuid(
+      ends.homePackage,
+      ends.src.entity.uuid,
+      ends.tgt.entity.uuid,
+      input.sourceEntityName,
+      input.targetEntityName,
+      services
+    );
+    if (typeof uuidOrFail !== "string") return uuidOrFail;
+    const relationship = {
+      uuid: uuidOrFail,
+      description: input.description ?? "",
+      source: { entity: ends.src.entity.uuid, cardinality: input.sourceCardinality },
+      target: { entity: ends.tgt.entity.uuid, cardinality: input.targetCardinality }
+    };
+    const validation = validateRelationshipMutation(relationship);
+    if (!validation.ok) return fail2(validation.error);
+    const result = await services.serviceService.updateRelationship(ends.homePackage, uuidOrFail, relationship);
+    if (!result.success) return fail2(result.errors.join("; ") || "Failed to update relationship.");
+    const name21 = relationshipName(input.sourceEntityName, input.targetEntityName);
+    const summary = `Updated relationship ${name21} (${cardinalityLabel(input.sourceCardinality)} \u2192 ${cardinalityLabel(input.targetCardinality)})`;
+    return {
+      success: true,
+      changeKind: "updated",
+      elementType: "relationship",
+      name: name21,
+      packageName: ends.homePackage,
+      summary,
+      message: summary
+    };
+  } catch (err) {
+    return fail2(err instanceof Error ? err.message : String(err));
+  }
+}
+async function executeDeleteRelationship(input, services) {
+  try {
+    let src;
+    let tgt;
+    try {
+      src = await services.serviceService.findEntityAcrossPackages(input.sourceEntityName, input.packageName);
+    } catch (e) {
+      return fail2(`Source: ${e instanceof Error ? e.message : String(e)}`);
+    }
+    if (!src) return fail2(`Source entity "${input.sourceEntityName}" not found in any package.`);
+    try {
+      tgt = await services.serviceService.findEntityAcrossPackages(input.targetEntityName, input.packageName);
+    } catch (e) {
+      return fail2(`Target: ${e instanceof Error ? e.message : String(e)}`);
+    }
+    if (!tgt) return fail2(`Target entity "${input.targetEntityName}" not found in any package.`);
+    const uuidOrFail = await findRelationshipUuid(
+      input.packageName,
+      src.entity.uuid,
+      tgt.entity.uuid,
+      input.sourceEntityName,
+      input.targetEntityName,
+      services
+    );
+    if (typeof uuidOrFail !== "string") return uuidOrFail;
+    const result = await services.serviceService.deleteRelationship(input.packageName, uuidOrFail);
+    if (!result.success) return fail2(result.errors.join("; ") || "Failed to delete relationship.");
+    const name21 = relationshipName(input.sourceEntityName, input.targetEntityName);
+    const summary = `Deleted relationship ${name21}`;
+    return {
+      success: true,
+      changeKind: "deleted",
+      elementType: "relationship",
+      name: name21,
+      packageName: input.packageName,
+      summary,
+      navigate: `/packages/${input.packageName}`,
+      message: summary
+    };
+  } catch (err) {
+    return fail2(err instanceof Error ? err.message : String(err));
+  }
+}
+var attributeInputSchema, createEntityInputSchema, updateEntityInputSchema, deleteEntityInputSchema, cardinalityValues, createRelationshipInputSchema, updateRelationshipInputSchema, deleteRelationshipInputSchema, attributeJsonSchema, createEntityParameters, updateEntityParameters, deleteEntityParameters, createRelationshipParameters, updateRelationshipParameters, deleteRelationshipParameters;
+var init_aiMutationTools = __esm({
+  "backend/src/controllers/aiMutationTools.ts"() {
+    "use strict";
+    init_zod();
+    init_EntitySchema();
+    init_dicoConfigService();
+    init_uuid();
+    attributeInputSchema = external_exports.object({
+      name: external_exports.string().describe("Attribute name (camelCase)"),
+      type: external_exports.string().describe("Standard AttributeType (string, integer, number, boolean, date, datetime, uuid, enum, \u2026) or a derived type name"),
+      description: external_exports.string().optional().describe("Attribute description"),
+      required: external_exports.boolean().optional().describe("Whether the attribute is required"),
+      primaryKey: external_exports.boolean().optional().describe("Whether the attribute is (part of) the primary key"),
+      enumValues: external_exports.array(external_exports.string()).optional().describe("Allowed values when type is enum")
+    });
+    createEntityInputSchema = external_exports.object({
+      packageName: external_exports.string().describe("Package/service the entity belongs to"),
+      name: external_exports.string().describe("Entity name (PascalCase)"),
+      description: external_exports.string().optional().describe("Entity description"),
+      stereotype: external_exports.string().optional().describe("Stereotype id (must applyTo entity), e.g. aggregate-root"),
+      attributes: external_exports.array(attributeInputSchema).describe("Entity attributes")
+    });
+    updateEntityInputSchema = createEntityInputSchema;
+    deleteEntityInputSchema = external_exports.object({
+      packageName: external_exports.string().describe("Package/service the entity belongs to"),
+      name: external_exports.string().describe("Entity name to delete")
+    });
+    cardinalityValues = ["one", "many"];
+    createRelationshipInputSchema = external_exports.object({
+      sourceEntityName: external_exports.string().describe("Source entity name"),
+      targetEntityName: external_exports.string().describe("Target entity name"),
+      sourcePackage: external_exports.string().optional().describe("Package containing the source entity (omit to scan all)"),
+      targetPackage: external_exports.string().optional().describe("Package containing the target entity (omit to scan all)"),
+      sourceCardinality: external_exports.enum(cardinalityValues).describe("Source-end cardinality"),
+      targetCardinality: external_exports.enum(cardinalityValues).describe("Target-end cardinality"),
+      description: external_exports.string().optional().describe("Relationship description")
+    });
+    updateRelationshipInputSchema = createRelationshipInputSchema;
+    deleteRelationshipInputSchema = external_exports.object({
+      packageName: external_exports.string().describe("Package the relationship is stored under (the source entity's package)"),
+      sourceEntityName: external_exports.string().describe("Source entity name"),
+      targetEntityName: external_exports.string().describe("Target entity name")
+    });
+    attributeJsonSchema = {
+      type: "object",
+      required: ["name", "type"],
+      properties: {
+        name: { type: "string", description: "Attribute name (camelCase)" },
+        type: { type: "string", description: "Standard AttributeType or a derived type name" },
+        description: { type: "string" },
+        required: { type: "boolean" },
+        primaryKey: { type: "boolean" },
+        enumValues: { type: "array", items: { type: "string" } }
+      }
+    };
+    createEntityParameters = {
+      type: "object",
+      required: ["packageName", "name", "attributes"],
+      properties: {
+        packageName: { type: "string", description: "Package/service the entity belongs to" },
+        name: { type: "string", description: "Entity name (PascalCase)" },
+        description: { type: "string" },
+        stereotype: { type: "string", description: "Stereotype id (entity), e.g. aggregate-root" },
+        attributes: { type: "array", items: attributeJsonSchema }
+      }
+    };
+    updateEntityParameters = createEntityParameters;
+    deleteEntityParameters = {
+      type: "object",
+      required: ["packageName", "name"],
+      properties: {
+        packageName: { type: "string" },
+        name: { type: "string", description: "Entity name to delete" }
+      }
+    };
+    createRelationshipParameters = {
+      type: "object",
+      required: ["sourceEntityName", "targetEntityName", "sourceCardinality", "targetCardinality"],
+      properties: {
+        sourceEntityName: { type: "string" },
+        targetEntityName: { type: "string" },
+        sourcePackage: { type: "string", description: "Package of source entity (omit to scan all)" },
+        targetPackage: { type: "string", description: "Package of target entity (omit to scan all)" },
+        sourceCardinality: { type: "string", enum: ["one", "many"] },
+        targetCardinality: { type: "string", enum: ["one", "many"] },
+        description: { type: "string" }
+      }
+    };
+    updateRelationshipParameters = createRelationshipParameters;
+    deleteRelationshipParameters = {
+      type: "object",
+      required: ["packageName", "sourceEntityName", "targetEntityName"],
+      properties: {
+        packageName: { type: "string", description: "Package the relationship is stored under (source entity's package)" },
+        sourceEntityName: { type: "string" },
+        targetEntityName: { type: "string" }
+      }
+    };
+    __name(fail2, "fail");
+    __name(cardinalityLabel, "cardinalityLabel");
+    __name(ensurePackage, "ensurePackage");
+    __name(packageExists, "packageExists");
+    __name(buildEntity, "buildEntity");
+    __name(validateEntityMutation, "validateEntityMutation");
+    __name(executeCreateEntity, "executeCreateEntity");
+    __name(executeUpdateEntity, "executeUpdateEntity");
+    __name(executeDeleteEntity, "executeDeleteEntity");
+    __name(resolveRelationshipEnds, "resolveRelationshipEnds");
+    __name(validateRelationshipMutation, "validateRelationshipMutation");
+    __name(relationshipName, "relationshipName");
+    __name(executeCreateRelationship, "executeCreateRelationship");
+    __name(findRelationshipUuid, "findRelationshipUuid");
+    __name(executeUpdateRelationship, "executeUpdateRelationship");
+    __name(executeDeleteRelationship, "executeDeleteRelationship");
+  }
+});
+
 // backend/node_modules/@ai-sdk/anthropic/dist/index.mjs
 var dist_exports2 = {};
 __export(dist_exports2, {
@@ -104125,12 +104751,12 @@ var init_dist7 = __esm({
       static {
         __name(this, "AnthropicMessagesLanguageModel");
       }
-      constructor(modelId, config3) {
+      constructor(modelId, config4) {
         this.specificationVersion = "v3";
         var _a21;
         this.modelId = modelId;
-        this.config = config3;
-        this.generateId = (_a21 = config3.generateId) != null ? _a21 : generateId;
+        this.config = config4;
+        this.generateId = (_a21 = config4.generateId) != null ? _a21 : generateId;
       }
       supportsUrl(url2) {
         return url2.protocol === "https:";
@@ -108177,13 +108803,13 @@ var init_dist8 = __esm({
       static {
         __name(this, "OpenAIChatLanguageModel");
       }
-      constructor(modelId, config3) {
+      constructor(modelId, config4) {
         this.specificationVersion = "v3";
         this.supportedUrls = {
           "image/*": [/^https?:\/\/.*$/]
         };
         this.modelId = modelId;
-        this.config = config3;
+        this.config = config4;
       }
       get provider() {
         return this.config.provider;
@@ -108764,13 +109390,13 @@ var init_dist8 = __esm({
       static {
         __name(this, "OpenAICompletionLanguageModel");
       }
-      constructor(modelId, config3) {
+      constructor(modelId, config4) {
         this.specificationVersion = "v3";
         this.supportedUrls = {
           // No URLs are supported for completion models.
         };
         this.modelId = modelId;
-        this.config = config3;
+        this.config = config4;
       }
       get providerOptionsName() {
         return this.config.provider.split(".")[0].trim();
@@ -109018,12 +109644,12 @@ var init_dist8 = __esm({
       static {
         __name(this, "OpenAIEmbeddingModel");
       }
-      constructor(modelId, config3) {
+      constructor(modelId, config4) {
         this.specificationVersion = "v3";
         this.maxEmbeddingsPerCall = 2048;
         this.supportsParallelCalls = true;
         this.modelId = modelId;
-        this.config = config3;
+        this.config = config4;
       }
       get provider() {
         return this.config.provider;
@@ -109125,9 +109751,9 @@ var init_dist8 = __esm({
       static {
         __name(this, "OpenAIImageModel");
       }
-      constructor(modelId, config3) {
+      constructor(modelId, config4) {
         this.modelId = modelId;
-        this.config = config3;
+        this.config = config4;
         this.specificationVersion = "v3";
       }
       get maxImagesPerCall() {
@@ -110958,14 +111584,14 @@ var init_dist8 = __esm({
       static {
         __name(this, "OpenAIResponsesLanguageModel");
       }
-      constructor(modelId, config3) {
+      constructor(modelId, config4) {
         this.specificationVersion = "v3";
         this.supportedUrls = {
           "image/*": [/^https?:\/\/.*$/],
           "application/pdf": [/^https?:\/\/.*$/]
         };
         this.modelId = modelId;
-        this.config = config3;
+        this.config = config4;
       }
       get provider() {
         return this.config.provider;
@@ -112590,9 +113216,9 @@ var init_dist8 = __esm({
       static {
         __name(this, "OpenAISpeechModel");
       }
-      constructor(modelId, config3) {
+      constructor(modelId, config4) {
         this.modelId = modelId;
-        this.config = config3;
+        this.config = config4;
         this.specificationVersion = "v3";
       }
       get provider() {
@@ -112809,9 +113435,9 @@ var init_dist8 = __esm({
       static {
         __name(this, "OpenAITranscriptionModel");
       }
-      constructor(modelId, config3) {
+      constructor(modelId, config4) {
         this.modelId = modelId;
-        this.config = config3;
+        this.config = config4;
         this.specificationVersion = "v3";
       }
       get provider() {
@@ -112926,26 +113552,27 @@ __export(aiDirectClient_exports, {
   AbortError: () => AbortError,
   callWithTools: () => callWithTools
 });
-async function callWithTools(config3, messages, tools, executeToolFn, maxSteps = 10, onEvent, signal) {
+async function callWithTools(config4, messages, tools, executeToolFn, maxSteps = 10, onEvent, signal) {
   let currentMessages = [...messages];
   const allToolCalls = [];
   let finalText = "";
   const callSeq = {};
   const usage = { inputTokens: 0, outputTokens: 0 };
+  let stoppedAtStepLimit = true;
   for (let step = 0; step < maxSteps; step++) {
     if (signal?.aborted) {
-      return { text: finalText, toolCalls: allToolCalls, aborted: true, usage };
+      return { text: finalText, toolCalls: allToolCalls, aborted: true, usage, stoppedAtStepLimit: false };
     }
     let response;
     try {
-      response = await fetch(`${config3.baseURL}/chat/completions`, {
+      response = await fetch(`${config4.baseURL}/chat/completions`, {
         method: "POST",
         headers: {
-          "Authorization": `Bearer ${config3.apiKey}`,
+          "Authorization": `Bearer ${config4.apiKey}`,
           "Content-Type": "application/json"
         },
         body: JSON.stringify({
-          model: config3.model,
+          model: config4.model,
           messages: currentMessages,
           tools: tools.length > 0 ? tools : void 0,
           tool_choice: tools.length > 0 ? "auto" : void 0,
@@ -112955,7 +113582,7 @@ async function callWithTools(config3, messages, tools, executeToolFn, maxSteps =
       });
     } catch (err) {
       if (err?.name === "AbortError" || signal?.aborted) {
-        return { text: finalText, toolCalls: allToolCalls, aborted: true, usage };
+        return { text: finalText, toolCalls: allToolCalls, aborted: true, usage, stoppedAtStepLimit: false };
       }
       throw err;
     }
@@ -113006,7 +113633,7 @@ async function callWithTools(config3, messages, tools, executeToolFn, maxSteps =
       });
       for (const tc of msg.tool_calls) {
         if (signal?.aborted) {
-          return { text: finalText, toolCalls: allToolCalls, aborted: true, usage };
+          return { text: finalText, toolCalls: allToolCalls, aborted: true, usage, stoppedAtStepLimit: false };
         }
         const toolName = tc.function.name;
         let toolArgs = {};
@@ -113035,9 +113662,53 @@ async function callWithTools(config3, messages, tools, executeToolFn, maxSteps =
       }
       continue;
     }
+    stoppedAtStepLimit = false;
     break;
   }
-  return { text: finalText, toolCalls: allToolCalls, usage };
+  if (stoppedAtStepLimit && !signal?.aborted) {
+    const nudgeMessages = [
+      ...currentMessages,
+      {
+        role: "user",
+        content: "You've reached the step limit and can't call more tools. Summarize what you changed and list the remaining steps to finish."
+      }
+    ];
+    try {
+      const response = await fetch(`${config4.baseURL}/chat/completions`, {
+        method: "POST",
+        headers: {
+          "Authorization": `Bearer ${config4.apiKey}`,
+          "Content-Type": "application/json"
+        },
+        body: JSON.stringify({
+          model: config4.model,
+          messages: nudgeMessages,
+          // tools omitted on purpose — the model cannot call more tools.
+          max_tokens: 4096
+        }),
+        signal
+      });
+      if (response.ok) {
+        const data = await response.json();
+        if (data.usage) {
+          const u = data.usage;
+          const inTok = typeof u.prompt_tokens === "number" ? u.prompt_tokens : typeof u.input_tokens === "number" ? u.input_tokens : 0;
+          const outTok = typeof u.completion_tokens === "number" ? u.completion_tokens : typeof u.output_tokens === "number" ? u.output_tokens : 0;
+          usage.inputTokens += inTok;
+          usage.outputTokens += outTok;
+        }
+        const summary = data.choices?.[0]?.message?.content || "";
+        if (summary) {
+          finalText = summary;
+        }
+      }
+    } catch (err) {
+      if (!(err?.name === "AbortError" || signal?.aborted)) {
+        logger.warn(`AI summary turn failed: ${err?.message ?? err}`);
+      }
+    }
+  }
+  return { text: finalText, toolCalls: allToolCalls, usage, stoppedAtStepLimit };
 }
 var AbortError;
 var init_aiDirectClient = __esm({
@@ -113375,8 +114046,12 @@ async function handleDirectChat(req, res, cfg, rawMessages, services, pageContex
     if (text2) messages.push({ role: msg.role, content: text2 });
   }
   const builtinToolDefs = [
-    { type: "function", function: { name: "createEntity", description: "Create an entity. entityJson is a JSON string with packageName, name, description, stereotype, attributes array.", parameters: { type: "object", required: ["entityJson"], properties: { entityJson: { type: "string", description: 'JSON: {"packageName":"pkg","name":"Entity","description":"...","attributes":[{"name":"id","type":"string","required":true,"primaryKey":true}]}' } } } } },
-    { type: "function", function: { name: "createRelationship", description: "Create a relationship. Endpoints may live in the same package or in different packages (cross-package is first-class). JSON string parameter.", parameters: { type: "object", required: ["relationshipJson"], properties: { relationshipJson: { type: "string", description: `JSON: {"packageName":"home-pkg","sourceEntityName":"A","sourcePackage":"pkg-of-A","targetEntityName":"B","targetPackage":"pkg-of-B","sourceCardinality":"one","targetCardinality":"many","description":"..."}. sourcePackage/targetPackage are optional \u2014 if omitted the resolver scans every package and errors on ambiguity. The relationship is stored under the source's package.` } } } } },
+    { type: "function", function: { name: "createEntity", description: "Create a new entity with attributes in a package. Structured fields: packageName, name, description, stereotype, attributes[].", parameters: createEntityParameters } },
+    { type: "function", function: { name: "updateEntity", description: "Update an existing entity. description/stereotype/attributes become the new desired state; uuid and createdAt are preserved.", parameters: updateEntityParameters } },
+    { type: "function", function: { name: "deleteEntity", description: "Delete an entity by package and name. Fails if still referenced by relationships (no auto-cascade).", parameters: deleteEntityParameters } },
+    { type: "function", function: { name: "createRelationship", description: "Create a relationship between two entities. Cross-package is first-class; omit sourcePackage/targetPackage to scan all packages. Stored under the source entity's package.", parameters: createRelationshipParameters } },
+    { type: "function", function: { name: "updateRelationship", description: "Update an existing relationship (resolved by matching source/target). Cardinalities and description become the new desired state.", parameters: updateRelationshipParameters } },
+    { type: "function", function: { name: "deleteRelationship", description: "Delete a relationship by its package (source entity's package) and source/target entity names.", parameters: deleteRelationshipParameters } },
     { type: "function", function: { name: "listEntities", description: "List packages or entities in a package", parameters: { type: "object", properties: { packageName: { type: "string", description: "Package name (omit to list all)" } } } } },
     { type: "function", function: { name: "listStereotypes", description: "List available stereotypes", parameters: { type: "object", properties: {} } } },
     { type: "function", function: { name: "navigateTo", description: 'Navigate user to a page. The path MUST be an absolute URL beginning with "/" that matches one of the patterns returned by listRoutes \u2014 call listRoutes first if you are unsure of the exact shape.', parameters: { type: "object", required: ["path", "reason"], properties: { path: { type: "string" }, reason: { type: "string" } } } } },
@@ -113395,70 +114070,24 @@ async function handleDirectChat(req, res, cfg, rawMessages, services, pageContex
   const toolDefs = allToolDefs.filter((t) => isToolAllowedForMode(t.function.name, mode));
   const executeTool2 = /* @__PURE__ */ __name(async (name21, args) => {
     try {
+      const mutationServices = services;
       if (name21 === "createEntity") {
-        let parsed;
-        try {
-          parsed = JSON.parse(args.entityJson || "{}");
-        } catch {
-          return { success: false, error: "Invalid JSON" };
-        }
-        if (!parsed.name || !parsed.attributes) return { success: false, error: "Missing name or attributes" };
-        const pkgName = parsed.packageName || "default";
-        const { listPackages: listPackages2, ensurePackageDirectoryStructure: ensurePackageDirectoryStructure2 } = await Promise.resolve().then(() => (init_fileOperations(), fileOperations_exports));
-        const existing = await listPackages2();
-        if (!existing.includes(pkgName)) await ensurePackageDirectoryStructure2(pkgName);
-        const entity = {
-          uuid: crypto.randomUUID(),
-          name: parsed.name,
-          description: parsed.description || "",
-          stereotype: parsed.stereotype,
-          status: "draft",
-          attributes: (parsed.attributes || []).map((a) => ({
-            uuid: crypto.randomUUID(),
-            name: a.name,
-            type: a.type || "string",
-            description: a.description || "",
-            required: a.required ?? false,
-            primaryKey: a.primaryKey,
-            validation: a.enumValues ? { enumValues: a.enumValues } : void 0
-          })),
-          createdAt: (/* @__PURE__ */ new Date()).toISOString(),
-          updatedAt: (/* @__PURE__ */ new Date()).toISOString()
-        };
-        await services.serviceService.createEntity(pkgName, entity);
-        return { success: true, message: `Created entity ${parsed.name} with ${entity.attributes.length} attributes`, navigate: `/packages/${pkgName}/entities/${parsed.name}` };
+        return await executeCreateEntity(args, mutationServices);
+      }
+      if (name21 === "updateEntity") {
+        return await executeUpdateEntity(args, mutationServices);
+      }
+      if (name21 === "deleteEntity") {
+        return await executeDeleteEntity(args, mutationServices);
       }
       if (name21 === "createRelationship") {
-        let p;
-        try {
-          p = JSON.parse(args.relationshipJson || "{}");
-        } catch {
-          return { success: false, error: "Invalid JSON" };
-        }
-        if (!p.sourceEntityName || !p.targetEntityName) return { success: false, error: "Missing entity names" };
-        const defaultPkg = p.packageName || "default";
-        let src, tgt;
-        try {
-          src = await services.serviceService.findEntityAcrossPackages(p.sourceEntityName, p.sourcePackage || defaultPkg);
-        } catch (e) {
-          return { success: false, error: `Source: ${e instanceof Error ? e.message : String(e)}` };
-        }
-        if (!src) return { success: false, error: `Source entity "${p.sourceEntityName}" not found in any package` };
-        try {
-          tgt = await services.serviceService.findEntityAcrossPackages(p.targetEntityName, p.targetPackage || defaultPkg);
-        } catch (e) {
-          return { success: false, error: `Target: ${e instanceof Error ? e.message : String(e)}` };
-        }
-        if (!tgt) return { success: false, error: `Target entity "${p.targetEntityName}" not found in any package` };
-        const homePackage = src.packageName;
-        await services.serviceService.createRelationship(homePackage, {
-          uuid: crypto.randomUUID(),
-          description: p.description || "",
-          source: { entity: src.entity.uuid, cardinality: p.sourceCardinality || "one" },
-          target: { entity: tgt.entity.uuid, cardinality: p.targetCardinality || "many" }
-        });
-        const crossNote = src.packageName !== tgt.packageName ? ` (cross-package: ${src.packageName} \u2192 ${tgt.packageName})` : "";
-        return { success: true, message: `Created relationship: ${p.sourceEntityName} -> ${p.targetEntityName}${crossNote}` };
+        return await executeCreateRelationship(args, mutationServices);
+      }
+      if (name21 === "updateRelationship") {
+        return await executeUpdateRelationship(args, mutationServices);
+      }
+      if (name21 === "deleteRelationship") {
+        return await executeDeleteRelationship(args, mutationServices);
       }
       if (name21 === "listEntities") {
         if (args.packageName) {
@@ -113502,7 +114131,7 @@ async function handleDirectChat(req, res, cfg, rawMessages, services, pageContex
       messages,
       toolDefs,
       executeTool2,
-      15,
+      AI_MAX_STEPS,
       (event) => {
         if (event.type === "text") {
           const id = crypto.randomUUID();
@@ -113543,6 +114172,9 @@ async function handleDirectChat(req, res, cfg, rawMessages, services, pageContex
           ...cost !== void 0 ? { cost } : {}
         });
       }
+      if (result.stoppedAtStepLimit) {
+        sendEvent({ type: "step-limit-reached", limit: AI_MAX_STEPS });
+      }
       sendEvent({ type: "finish", finishReason: "stop" });
     }
   } catch (err) {
@@ -113605,11 +114237,12 @@ var init_aiController = __esm({
     init_dist6();
     init_zod();
     init_logger();
+    init_config();
     init_appDir();
     init_conversationService();
     init_promptService();
-    init_EntitySchema();
     init_mcpClientRegistry();
+    init_aiMutationTools();
     TOOL_CATEGORY_MAP = {
       // read
       listEntities: "read",
@@ -113677,18 +114310,17 @@ When creating data models:
 - Suggest stereotypes when applicable (aggregate-root, reference-data, event, value-object for entities)
 - Create relationships with proper cardinality
 
-IMPORTANT: For createEntity and createRelationship tools, you must pass a SINGLE parameter called entityJson or relationshipJson containing a valid JSON string with all the data.
-
-Example createEntity call:
-entityJson: '{"packageName":"e-commerce","name":"Product","description":"A product in the catalog","stereotype":"aggregate-root","attributes":[{"name":"productId","type":"string","description":"Unique product ID","required":true,"primaryKey":true},{"name":"name","type":"string","description":"Product name","required":true},{"name":"price","type":"number","description":"Product price","required":true}]}'
+Mutation tools take STRUCTURED parameters (not JSON strings):
+- createEntity / updateEntity: { packageName, name, description?, stereotype?, attributes: [{ name, type, description?, required?, primaryKey?, enumValues? }] }. For updateEntity the provided description/stereotype/attributes become the new desired state.
+- deleteEntity: { packageName, name }. Fails if the entity is still referenced by relationships \u2014 delete those relationships first (no auto-cascade).
+- createRelationship / updateRelationship: { sourceEntityName, targetEntityName, sourcePackage?, targetPackage?, sourceCardinality, targetCardinality, description? }. Cardinality is "one" or "many".
+- deleteRelationship: { packageName, sourceEntityName, targetEntityName } where packageName is the source entity's package.
 
-Cross-package relationships are first-class. When source and target live in different packages, pass sourcePackage and targetPackage explicitly:
-relationshipJson: '{"sourceEntityName":"Order","sourcePackage":"order-service","targetEntityName":"User","targetPackage":"user-service","sourceCardinality":"many","targetCardinality":"one","description":"placed by"}'
-The relationship is stored under the source's package. If sourcePackage/targetPackage are omitted the resolver scans every package and errors on ambiguity.
+Cross-package relationships are first-class. When source and target live in different packages, pass sourcePackage and targetPackage explicitly. The relationship is stored under the source's package. If sourcePackage/targetPackage are omitted the resolver scans every package and errors on ambiguity.
 
 When the user asks to create a model:
 1. Infer a package name from context (e.g. "e-commerce data model" \u2192 packageName: "e-commerce").
-2. ALWAYS include packageName in every entityJson. For relationshipJson include sourcePackage/targetPackage when the endpoints span multiple packages.
+2. ALWAYS include packageName when creating entities. For relationships include sourcePackage/targetPackage when the endpoints span multiple packages.
 3. Create ALL entities first, then ALL relationships.
 4. After creating everything, use navigateTo to show the package page.
 
@@ -113755,6 +114387,7 @@ Be concise in your responses. Show a summary of what you created.`;
         req.on("close", onAbort);
         req.on("aborted", onAbort);
         let aggregatedUsage = null;
+        let stoppedAtStepLimit = false;
         const result = streamText({
           model,
           system: buildSystemPrompt(enrichedPageContext, conversationSystemPrompt, mode),
@@ -113768,112 +114401,61 @@ Be concise in your responses. Show a summary of what you created.`;
                 outputTokens: tu.outputTokens ?? 0
               };
             }
+            stoppedAtStepLimit = event.finishReason === "tool-calls" && event.steps.length >= AI_MAX_STEPS;
           }, "onFinish"),
           tools: filterToolsForMode({
             createEntity: tool({
-              description: 'Create a new entity with attributes in a package. The entityJson parameter must be a JSON string with this structure: {"packageName":"pkg","name":"EntityName","description":"...","stereotype":"aggregate-root","attributes":[{"name":"id","type":"string","description":"...","required":true,"primaryKey":true}]}',
-              inputSchema: external_exports.object({
-                entityJson: external_exports.string().describe("JSON string containing packageName, name, description, stereotype (optional), and attributes array. Each attribute has name, type, description, required, primaryKey (optional), enumValues (optional).")
-              }),
+              description: "Create a new entity with attributes in a package. Provide structured fields (packageName, name, description, stereotype, attributes[]). Each attribute: { name, type, description, required, primaryKey, enumValues }.",
+              inputSchema: createEntityInputSchema,
               execute: /* @__PURE__ */ __name(async (params) => {
-                try {
-                  let parsed;
-                  try {
-                    parsed = JSON.parse(params.entityJson || "{}");
-                  } catch {
-                    return { success: false, error: "Invalid JSON in entityJson parameter" };
-                  }
-                  if (!parsed.name || !parsed.attributes) {
-                    return {
-                      success: false,
-                      error: 'entityJson must contain name and attributes. Example: {"packageName":"e-commerce","name":"Product","description":"...","attributes":[{"name":"id","type":"string","description":"...","required":true}]}'
-                    };
-                  }
-                  const pkgName = parsed.packageName || "default";
-                  const { listPackages: listPackages2, ensurePackageDirectoryStructure: ensurePackageDirectoryStructure2 } = await Promise.resolve().then(() => (init_fileOperations(), fileOperations_exports));
-                  const existingServices = await listPackages2();
-                  if (!existingServices.includes(pkgName)) {
-                    await ensurePackageDirectoryStructure2(pkgName);
-                  }
-                  const attrs = (parsed.attributes || []).map((a) => ({
-                    uuid: crypto.randomUUID(),
-                    name: a.name,
-                    type: a.type || "string",
-                    description: a.description || "",
-                    required: a.required ?? false,
-                    primaryKey: a.primaryKey,
-                    validation: a.enumValues ? { enumValues: a.enumValues } : void 0
-                  }));
-                  const entity = {
-                    uuid: crypto.randomUUID(),
-                    name: parsed.name,
-                    description: parsed.description || "",
-                    stereotype: parsed.stereotype,
-                    status: "draft" /* DRAFT */,
-                    attributes: attrs,
-                    createdAt: (/* @__PURE__ */ new Date()).toISOString(),
-                    updatedAt: (/* @__PURE__ */ new Date()).toISOString()
-                  };
-                  await services.serviceService.createEntity(pkgName, entity);
-                  logger.info(`AI created entity: ${pkgName}/${parsed.name}`);
-                  return {
-                    success: true,
-                    message: `Created entity ${parsed.name} with ${attrs.length} attributes`,
-                    navigate: `/packages/${pkgName}/entities/${parsed.name}`
-                  };
-                } catch (err) {
-                  return { success: false, error: err.message };
-                }
+                const result2 = await executeCreateEntity(params, services);
+                if (result2.success) logger.info(`AI created entity: ${result2.packageName}/${result2.name}`);
+                return result2;
+              }, "execute")
+            }),
+            updateEntity: tool({
+              description: "Update an existing entity. The provided description/stereotype/attributes become the new desired state; the entity uuid and createdAt are preserved. Same structured shape as createEntity.",
+              inputSchema: updateEntityInputSchema,
+              execute: /* @__PURE__ */ __name(async (params) => {
+                const result2 = await executeUpdateEntity(params, services);
+                if (result2.success) logger.info(`AI updated entity: ${result2.packageName}/${result2.name}`);
+                return result2;
+              }, "execute")
+            }),
+            deleteEntity: tool({
+              description: "Delete an entity by package and name. Fails (and reports) if the entity is still referenced by relationships \u2014 remove those relationships first; the tool never auto-cascades.",
+              inputSchema: deleteEntityInputSchema,
+              execute: /* @__PURE__ */ __name(async (params) => {
+                const result2 = await executeDeleteEntity(params, services);
+                if (result2.success) logger.info(`AI deleted entity: ${result2.packageName}/${result2.name}`);
+                return result2;
               }, "execute")
             }),
             createRelationship: tool({
-              description: `Create a relationship between two entities. Endpoints may live in the same package or in different packages (cross-package is first-class). Pass a JSON string: {"packageName":"home-pkg","sourceEntityName":"Order","sourcePackage":"order-service","targetEntityName":"User","targetPackage":"user-service","description":"...","sourceCardinality":"many","targetCardinality":"one"}. sourcePackage/targetPackage are optional \u2014 if omitted the resolver falls back to packageName and then scans every package, erroring on ambiguity. The relationship is stored under the source's package by convention.`,
-              inputSchema: external_exports.object({
-                relationshipJson: external_exports.string().describe("JSON with packageName (optional, fallback), sourceEntityName, sourcePackage (optional), targetEntityName, targetPackage (optional), description, sourceCardinality (one|many), targetCardinality (one|many)")
-              }),
+              description: "Create a relationship between two entities. Endpoints may live in the same or different packages (cross-package is first-class). Provide sourceEntityName, targetEntityName, optional sourcePackage/targetPackage (omit to scan all packages, errors on ambiguity), sourceCardinality and targetCardinality (one|many), and an optional description. The relationship is stored under the source entity's package.",
+              inputSchema: createRelationshipInputSchema,
               execute: /* @__PURE__ */ __name(async (params) => {
-                try {
-                  let p;
-                  try {
-                    p = JSON.parse(params.relationshipJson || "{}");
-                  } catch {
-                    return { success: false, error: "Invalid JSON in relationshipJson" };
-                  }
-                  if (!p.sourceEntityName || !p.targetEntityName) {
-                    return { success: false, error: "Missing sourceEntityName or targetEntityName in JSON" };
-                  }
-                  const defaultPkg = p.packageName || "default";
-                  let src, tgt;
-                  try {
-                    src = await services.serviceService.findEntityAcrossPackages(p.sourceEntityName, p.sourcePackage || defaultPkg);
-                  } catch (e) {
-                    return { success: false, error: `Source: ${e instanceof Error ? e.message : String(e)}` };
-                  }
-                  if (!src) {
-                    return { success: false, error: `Source entity "${p.sourceEntityName}" not found in any package` };
-                  }
-                  try {
-                    tgt = await services.serviceService.findEntityAcrossPackages(p.targetEntityName, p.targetPackage || defaultPkg);
-                  } catch (e) {
-                    return { success: false, error: `Target: ${e instanceof Error ? e.message : String(e)}` };
-                  }
-                  if (!tgt) {
-                    return { success: false, error: `Target entity "${p.targetEntityName}" not found in any package` };
-                  }
-                  const homePackage = src.packageName;
-                  const relationship = {
-                    uuid: crypto.randomUUID(),
-                    description: p.description || "",
-                    source: { entity: src.entity.uuid, cardinality: p.sourceCardinality || "one" },
-                    target: { entity: tgt.entity.uuid, cardinality: p.targetCardinality || "many" }
-                  };
-                  await services.serviceService.createRelationship(homePackage, relationship);
-                  const crossNote = src.packageName !== tgt.packageName ? ` (cross-package: ${src.packageName} \u2192 ${tgt.packageName}, stored under ${homePackage})` : "";
-                  logger.info(`AI created relationship: ${p.sourceEntityName} -> ${p.targetEntityName}${crossNote}`);
-                  return { success: true, message: `Created relationship: ${p.sourceEntityName} -> ${p.targetEntityName}${crossNote}` };
-                } catch (err) {
-                  return { success: false, error: err.message };
-                }
+                const result2 = await executeCreateRelationship(params, services);
+                if (result2.success) logger.info(`AI created relationship: ${result2.name}`);
+                return result2;
+              }, "execute")
+            }),
+            updateRelationship: tool({
+              description: "Update an existing relationship between two entities. The relationship is resolved by matching source/target entities; cardinalities and description become the new desired state.",
+              inputSchema: updateRelationshipInputSchema,
+              execute: /* @__PURE__ */ __name(async (params) => {
+                const result2 = await executeUpdateRelationship(params, services);
+                if (result2.success) logger.info(`AI updated relationship: ${result2.name}`);
+                return result2;
+              }, "execute")
+            }),
+            deleteRelationship: tool({
+              description: "Delete a relationship by its package (the source entity's package) and the source/target entity names.",
+              inputSchema: deleteRelationshipInputSchema,
+              execute: /* @__PURE__ */ __name(async (params) => {
+                const result2 = await executeDeleteRelationship(params, services);
+                if (result2.success) logger.info(`AI deleted relationship: ${result2.name}`);
+                return result2;
               }, "execute")
             }),
             listEntities: tool({
@@ -113960,7 +114542,7 @@ Be concise in your responses. Show a summary of what you created.`;
             // #178 — MCP tools merged at chat-request time
             ...mcpToolEntries
           }, mode),
-          stopWhen: stepCountIs(20)
+          stopWhen: stepCountIs(AI_MAX_STEPS)
         });
         const response = result.toUIMessageStreamResponse();
         res.status(response.status || 200);
@@ -114023,6 +114605,44 @@ Be concise in your responses. Show a summary of what you created.`;
               }
               const { done, value } = chunk;
               if (done) {
+                if (stoppedAtStepLimit && !ac.signal.aborted) {
+                  try {
+                    const prior = await result.response;
+                    const summary = await generateText({
+                      model,
+                      system: buildSystemPrompt(enrichedPageContext, conversationSystemPrompt, mode),
+                      messages: [
+                        ...messages,
+                        ...prior.messages,
+                        {
+                          role: "user",
+                          content: "You've reached the step limit and can't call more tools. Summarize what you changed and list the remaining steps to finish."
+                        }
+                      ],
+                      // No tools — the model cannot call more this turn.
+                      abortSignal: ac.signal
+                    });
+                    if (summary.text) {
+                      const summaryId = crypto.randomUUID();
+                      res.write(`data: ${JSON.stringify({ type: "text-start", id: summaryId })}
+
+`);
+                      for (const word of summary.text.split(" ")) {
+                        res.write(`data: ${JSON.stringify({ type: "text-delta", id: summaryId, delta: word + " " })}
+
+`);
+                      }
+                      if (summary.usage && aggregatedUsage) {
+                        aggregatedUsage = {
+                          inputTokens: aggregatedUsage.inputTokens + (summary.usage.inputTokens ?? 0),
+                          outputTokens: aggregatedUsage.outputTokens + (summary.usage.outputTokens ?? 0)
+                        };
+                      }
+                    }
+                  } catch (err) {
+                    logger.warn(`AI SDK summary turn failed: ${err instanceof Error ? err.message : String(err)}`);
+                  }
+                }
                 if (aggregatedUsage && (aggregatedUsage.inputTokens > 0 || aggregatedUsage.outputTokens > 0)) {
                   const cost = computeCost(
                     aggregatedUsage.inputTokens,
@@ -114039,6 +114659,14 @@ Be concise in your responses. Show a summary of what you created.`;
                       ...cost !== void 0 ? { cost } : {}
                     })}
 
+`);
+                  } catch {
+                  }
+                }
+                if (stoppedAtStepLimit) {
+                  try {
+                    res.write(`data: ${JSON.stringify({ type: "step-limit-reached", limit: AI_MAX_STEPS })}
+
 `);
                   } catch {
                   }
@@ -114178,26 +114806,70 @@ Be concise in your responses. Show a summary of what you created.`;
           parameters: [
             { name: "packageName", type: "string", required: true, description: "Package/service name" },
             { name: "name", type: "string", required: true, description: "Entity name (PascalCase)" },
-            { name: "description", type: "string", required: true, description: "Entity description" },
+            { name: "description", type: "string", required: false, description: "Entity description" },
             { name: "stereotype", type: "string", required: false, description: "Stereotype: aggregate-root, reference-data, event, value-object" },
             { name: "attributes", type: "array", required: true, description: "Array of {name, type, description, required, primaryKey?, enumValues?}" }
           ]
         },
+        {
+          name: "updateEntity",
+          description: "Update an existing entity; provided fields become the new desired state (uuid/createdAt preserved)",
+          source: "builtin",
+          parameters: [
+            { name: "packageName", type: "string", required: true, description: "Package/service name" },
+            { name: "name", type: "string", required: true, description: "Entity name (PascalCase)" },
+            { name: "description", type: "string", required: false, description: "Entity description" },
+            { name: "stereotype", type: "string", required: false, description: "Stereotype id" },
+            { name: "attributes", type: "array", required: true, description: "New desired attribute set: {name, type, description, required, primaryKey?, enumValues?}" }
+          ]
+        },
+        {
+          name: "deleteEntity",
+          description: "Delete an entity by package and name (fails if referenced by relationships)",
+          source: "builtin",
+          parameters: [
+            { name: "packageName", type: "string", required: true, description: "Package/service name" },
+            { name: "name", type: "string", required: true, description: "Entity name to delete" }
+          ]
+        },
         {
           name: "createRelationship",
           description: "Create a relationship between two entities. Endpoints may live in the same package or in different packages.",
           source: "builtin",
           parameters: [
-            { name: "packageName", type: "string", required: false, description: "Fallback package for both endpoints when sourcePackage/targetPackage are omitted" },
             { name: "sourceEntityName", type: "string", required: true, description: "Source entity name" },
-            { name: "sourcePackage", type: "string", required: false, description: "Package containing the source entity (defaults to packageName)" },
             { name: "targetEntityName", type: "string", required: true, description: "Target entity name" },
-            { name: "targetPackage", type: "string", required: false, description: "Package containing the target entity (defaults to packageName)" },
-            { name: "description", type: "string", required: true, description: "Relationship description" },
+            { name: "sourcePackage", type: "string", required: false, description: "Package containing the source entity (omit to scan all)" },
+            { name: "targetPackage", type: "string", required: false, description: "Package containing the target entity (omit to scan all)" },
+            { name: "description", type: "string", required: false, description: "Relationship description" },
+            { name: "sourceCardinality", type: "one|many", required: true, description: "Source cardinality" },
+            { name: "targetCardinality", type: "one|many", required: true, description: "Target cardinality" }
+          ]
+        },
+        {
+          name: "updateRelationship",
+          description: "Update an existing relationship (resolved by matching source/target entities)",
+          source: "builtin",
+          parameters: [
+            { name: "sourceEntityName", type: "string", required: true, description: "Source entity name" },
+            { name: "targetEntityName", type: "string", required: true, description: "Target entity name" },
+            { name: "sourcePackage", type: "string", required: false, description: "Package containing the source entity (omit to scan all)" },
+            { name: "targetPackage", type: "string", required: false, description: "Package containing the target entity (omit to scan all)" },
+            { name: "description", type: "string", required: false, description: "Relationship description" },
             { name: "sourceCardinality", type: "one|many", required: true, description: "Source cardinality" },
             { name: "targetCardinality", type: "one|many", required: true, description: "Target cardinality" }
           ]
         },
+        {
+          name: "deleteRelationship",
+          description: "Delete a relationship by its package (source entity's package) and source/target entity names",
+          source: "builtin",
+          parameters: [
+            { name: "packageName", type: "string", required: true, description: "Package the relationship is stored under (source entity's package)" },
+            { name: "sourceEntityName", type: "string", required: true, description: "Source entity name" },
+            { name: "targetEntityName", type: "string", required: true, description: "Target entity name" }
+          ]
+        },
         {
           name: "listEntities",
           description: "List all entities in a package or all packages",
@@ -114829,14 +115501,14 @@ var init_file_router = __esm({
 });
 
 // backend/node_modules/@hamak/filesystem-server-impl/dist/routing/create-router.js
-function createFileSystemRouter(workspaceManager2, config3) {
+function createFileSystemRouter(workspaceManager2, config4) {
   const app2 = (0, import_express30.Router)();
-  if (config3.enableCors ?? DEFAULT_FILESYSTEM_SERVER_CONFIG.enableCors) {
+  if (config4.enableCors ?? DEFAULT_FILESYSTEM_SERVER_CONFIG.enableCors) {
     app2.use((0, import_cors.default)());
   }
   app2.use(import_body_parser.default.json());
   const fileRouter2 = new FileRouter(workspaceManager2);
-  const mountPath = config3.mountPath ?? DEFAULT_FILESYSTEM_SERVER_CONFIG.mountPath;
+  const mountPath = config4.mountPath ?? DEFAULT_FILESYSTEM_SERVER_CONFIG.mountPath;
   app2.use(mountPath, fileRouter2.router);
   return app2;
 }
@@ -114871,17 +115543,17 @@ var init_filesystem_server_plugin = __esm({
        */
       initialize(ctx) {
         console.log("[FileSystemServerPlugin] Initializing...");
-        const config3 = ctx.resolve(FILESYSTEM_SERVER_CONFIG_TOKEN);
-        const workspaceManager2 = new WorkspaceManager(config3.workspaces, {
-          baseDirectory: config3.baseDirectory
+        const config4 = ctx.resolve(FILESYSTEM_SERVER_CONFIG_TOKEN);
+        const workspaceManager2 = new WorkspaceManager(config4.workspaces, {
+          baseDirectory: config4.baseDirectory
         });
         ctx.provide({
           provide: WORKSPACE_MANAGER_TOKEN,
           useValue: workspaceManager2
         });
         console.log("[FileSystemServerPlugin] WorkspaceManager service registered");
-        console.log(`[FileSystemServerPlugin] Base directory: ${config3.baseDirectory}`);
-        console.log(`[FileSystemServerPlugin] Workspaces:`, Object.keys(config3.workspaces));
+        console.log(`[FileSystemServerPlugin] Base directory: ${config4.baseDirectory}`);
+        console.log(`[FileSystemServerPlugin] Workspaces:`, Object.keys(config4.workspaces));
       }
       /**
        * Activate phase - create router and make ready for use
@@ -114889,10 +115561,10 @@ var init_filesystem_server_plugin = __esm({
       activate(ctx) {
         console.log("[FileSystemServerPlugin] Activating...");
         const workspaceManager2 = ctx.resolve(WORKSPACE_MANAGER_TOKEN);
-        const config3 = ctx.resolve(FILESYSTEM_SERVER_CONFIG_TOKEN);
-        this.router = createFileSystemRouter(workspaceManager2, config3);
+        const config4 = ctx.resolve(FILESYSTEM_SERVER_CONFIG_TOKEN);
+        this.router = createFileSystemRouter(workspaceManager2, config4);
         console.log("[FileSystemServerPlugin] Activated successfully");
-        console.log(`[FileSystemServerPlugin] Mount path: ${config3.mountPath ?? "/api/workspaces"}`);
+        console.log(`[FileSystemServerPlugin] Mount path: ${config4.mountPath ?? "/api/workspaces"}`);
       }
       /**
        * Deactivate phase - cleanup
@@ -114919,8 +115591,8 @@ var init_filesystem_server_plugin = __esm({
 });
 
 // backend/node_modules/@hamak/filesystem-server-impl/dist/middleware/workspace-validator.js
-function createWorkspaceValidator(config3) {
-  const workspaces = config3.workspaces;
+function createWorkspaceValidator(config4) {
+  const workspaces = config4.workspaces;
   return (req, res, next) => {
     const workspace = req.params.workspace;
     if (!workspace) {
@@ -156395,150 +157067,8 @@ var model_metadata_routes_default = router9;
 // backend/src/routes/data-dictionary/dico-config.routes.ts
 var import_express11 = __toESM(require_express2(), 1);
 
-// backend/src/services/dicoConfigService.ts
-init_EntitySchema();
-init_logger();
-init_StorageBackendToken();
-init_types();
-var DOMAIN_KINDS = /* @__PURE__ */ new Set(["enum", "codelist", "reference"]);
-var DICT_WS2 = wsId("dictionaries");
-var CONFIG_PATH = pathOf("dico.config.json");
-var STANDARD_TYPES = new Set(Object.values(AttributeType));
-async function readConfig() {
-  try {
-    const raw = await storageRegistry.getBackend().read(DICT_WS2, CONFIG_PATH);
-    const parsed = JSON.parse(raw);
-    if (typeof parsed.version !== "number") parsed.version = 1;
-    return parsed;
-  } catch (e) {
-    if (e.code === "not-found") return { version: 1 };
-    logger.error(`Failed to read dico.config.json: ${e}`);
-    return { version: 1 };
-  }
-}
-__name(readConfig, "readConfig");
-async function writeConfig(next) {
-  const body = JSON.stringify(next, null, 2) + "\n";
-  await storageRegistry.getBackend().write(DICT_WS2, CONFIG_PATH, body);
-}
-__name(writeConfig, "writeConfig");
-async function listDerivedTypes() {
-  const cfg = await readConfig();
-  return Array.isArray(cfg.types) ? cfg.types : [];
-}
-__name(listDerivedTypes, "listDerivedTypes");
-async function replaceDerivedTypes(next) {
-  const errors = validateDerivedTypes(next);
-  if (errors.length > 0) return { success: false, errors };
-  const cfg = await readConfig();
-  cfg.types = next;
-  await writeConfig(cfg);
-  return { success: true };
-}
-__name(replaceDerivedTypes, "replaceDerivedTypes");
-function validateDerivedTypes(types) {
-  const errors = [];
-  const byName = /* @__PURE__ */ new Map();
-  for (const t of types) {
-    if (!t?.name || typeof t.name !== "string") {
-      errors.push("Each derived type must have a `name` string");
-      continue;
-    }
-    if (STANDARD_TYPES.has(t.name)) {
-      errors.push(`Derived type name '${t.name}' shadows a standard AttributeType`);
-    }
-    if (byName.has(t.name)) {
-      errors.push(`Duplicate derived type name: '${t.name}'`);
-    } else {
-      byName.set(t.name, t);
-    }
-    if (!t.basedOn || typeof t.basedOn !== "string") {
-      errors.push(`Derived type '${t.name}' must declare a \`basedOn\``);
-    }
-    if (t.domain) errors.push(...validateDomain(t.name, t.domain));
-  }
-  for (const t of types) {
-    if (!t?.name || !t?.basedOn) continue;
-    const visited = /* @__PURE__ */ new Set();
-    let cursor = t.basedOn;
-    while (cursor && !STANDARD_TYPES.has(cursor)) {
-      if (visited.has(cursor)) {
-        errors.push(`Circular derivation starting at '${t.name}' (cycle via '${cursor}')`);
-        break;
-      }
-      visited.add(cursor);
-      const next = byName.get(cursor);
-      if (!next) {
-        errors.push(`Derived type '${t.name}' references unknown type '${cursor}'`);
-        break;
-      }
-      cursor = next.basedOn;
-    }
-  }
-  return errors;
-}
-__name(validateDerivedTypes, "validateDerivedTypes");
-function validateDomain(typeName, domain2) {
-  const errors = [];
-  if (!DOMAIN_KINDS.has(domain2.kind)) {
-    errors.push(`Derived type '${typeName}' has invalid domain kind '${domain2.kind}'`);
-    return errors;
-  }
-  const hasValues = Array.isArray(domain2.values) && domain2.values.length > 0;
-  const hasSource = typeof domain2.source === "string" && domain2.source.trim().length > 0;
-  if (domain2.kind === "enum") {
-    if (!hasValues) errors.push(`Enum domain '${typeName}' must list at least one value`);
-    if (hasSource) errors.push(`Enum domain '${typeName}' must not declare a \`source\``);
-  } else if (domain2.kind === "codelist") {
-    if (!hasSource) errors.push(`Codelist domain '${typeName}' must declare a \`source\` name`);
-  } else if (domain2.kind === "reference") {
-    if (!hasSource) errors.push(`Reference domain '${typeName}' must declare a \`source\` name`);
-    if (hasValues) errors.push(`Reference domain '${typeName}' must not carry inline \`values\` (they come from the source)`);
-  }
-  return errors;
-}
-__name(validateDomain, "validateDomain");
-function resolveDomain(typeName, derivedTypes) {
-  if (STANDARD_TYPES.has(typeName)) return null;
-  const byName = new Map(derivedTypes.map((t) => [t.name, t]));
-  const visited = /* @__PURE__ */ new Set();
-  let cursor = typeName;
-  while (!STANDARD_TYPES.has(cursor)) {
-    if (visited.has(cursor)) return null;
-    visited.add(cursor);
-    const dt = byName.get(cursor);
-    if (!dt) return null;
-    if (dt.domain) return dt.domain;
-    cursor = dt.basedOn;
-  }
-  return null;
-}
-__name(resolveDomain, "resolveDomain");
-function resolveAttributeType(typeName, derivedTypes) {
-  if (STANDARD_TYPES.has(typeName)) {
-    return { baseType: typeName, validation: {} };
-  }
-  const byName = new Map(derivedTypes.map((t) => [t.name, t]));
-  const chain = [];
-  const visited = /* @__PURE__ */ new Set();
-  let cursor = typeName;
-  while (!STANDARD_TYPES.has(cursor)) {
-    if (visited.has(cursor)) return null;
-    visited.add(cursor);
-    const dt = byName.get(cursor);
-    if (!dt) return null;
-    chain.push(dt);
-    cursor = dt.basedOn;
-  }
-  const merged = {};
-  for (let i = chain.length - 1; i >= 0; i--) {
-    Object.assign(merged, chain[i].validation || {});
-  }
-  return { baseType: cursor, validation: merged };
-}
-__name(resolveAttributeType, "resolveAttributeType");
-
 // backend/src/controllers/dicoConfigController.ts
+init_dicoConfigService();
 init_logger();
 var getDerivedTypes = /* @__PURE__ */ __name(async (_req, res) => {
   try {
@@ -158878,7 +159408,7 @@ var PhysicalConfigService = class {
    * service directory doesn't exist — configs for unknown services are a
    * caller bug, not something to silently create.
    */
-  async set(serviceName, config3) {
+  async set(serviceName, config4) {
     try {
       await this.storage.stat(this.ws, pathOf(serviceName));
     } catch (e) {
@@ -158888,8 +159418,8 @@ var PhysicalConfigService = class {
       throw e;
     }
     const safe = {
-      dialect: config3.dialect,
-      connection: { ...config3.connection }
+      dialect: config4.dialect,
+      connection: { ...config4.connection }
     };
     const conn = safe.connection;
     delete conn.user;
@@ -158912,11 +159442,11 @@ var _instance = new PhysicalConfigService();
 var getPhysicalConfig = /* @__PURE__ */ __name((s) => _instance.get(s), "getPhysicalConfig");
 var setPhysicalConfig = /* @__PURE__ */ __name((s, c) => _instance.set(s, c), "setPhysicalConfig");
 var deletePhysicalConfig = /* @__PURE__ */ __name((s) => _instance.delete(s), "deletePhysicalConfig");
-function mergeCredentials(config3, credentials) {
+function mergeCredentials(config4, credentials) {
   return {
-    dialect: config3.dialect,
+    dialect: config4.dialect,
     connection: {
-      ...config3.connection,
+      ...config4.connection,
       user: credentials.user,
       password: credentials.password
     }
@@ -160023,13 +160553,13 @@ var exportMigration = /* @__PURE__ */ __name(async (req, res) => {
   }
 }, "exportMigration");
 async function introspectServiceLive(serviceName, credentials, connectionOverrides) {
-  const config3 = await getPhysicalConfig(serviceName);
-  if (!config3) {
+  const config4 = await getPhysicalConfig(serviceName);
+  if (!config4) {
     throw new Error(`No physical.yaml config for service '${serviceName}'`);
   }
-  const hydrated = mergeCredentials(config3, credentials);
+  const hydrated = mergeCredentials(config4, credentials);
   const connection = { ...hydrated.connection, ...connectionOverrides || {} };
-  switch (config3.dialect) {
+  switch (config4.dialect) {
     case "oracle": {
       const result = await introspectOracle({
         connection
@@ -160067,7 +160597,7 @@ async function introspectServiceLive(serviceName, credentials, connectionOverrid
       return result.entities;
     }
     default:
-      throw new Error(`Unknown dialect '${config3.dialect}'`);
+      throw new Error(`Unknown dialect '${config4.dialect}'`);
   }
 }
 __name(introspectServiceLive, "introspectServiceLive");
@@ -160334,6 +160864,7 @@ var import_express13 = __toESM(require_express2(), 1);
 // backend/src/services/exportService.ts
 init_EntitySchema();
 init_fileOperations();
+init_dicoConfigService();
 init_metadata();
 var ATTR_TO_JSON_SCHEMA = {
   ["string" /* STRING */]: "string",