@memoarchitect/tools 0.4.6 → 0.6.0

package/packages/tools/lib/server/file-watcher.js

@@ -3,38 +3,72 @@
 // Two-scope watchers: project files (hot reload) and ontology files (restart).
 // ─────────────────────────────────────────────────────────────────────────────
 import chokidar from 'chokidar';
-import { extname, relative, resolve, sep } from 'node:path';
+import { extname, isAbsolute, relative, resolve, sep } from 'node:path';
 import { existsSync } from 'node:fs';
 const IGNORED_DIR_NAMES = new Set(['node_modules', '.memo', 'dist', 'lib']);
 function isInIgnoredDir(filePath) {
     return resolve(filePath).split(sep).some(part => IGNORED_DIR_NAMES.has(part));
 }
+/** True when `filePath` is inside `dir` (or is `dir` itself). */
+function isWithin(dir, filePath) {
+    const rel = relative(dir, filePath);
+    return rel === '' || (rel !== '..' && !rel.startsWith(`..${sep}`) && !isAbsolute(rel));
+}
+/**
+ * Debounce a burst of file events into one call, keeping the set of paths seen
+ * during the burst. A single save can emit several events, and a branch switch
+ * emits hundreds — the caller wants one rebuild and the full list.
+ */
 function makeDebounced(onChange, debounceMs) {
     let timer = null;
-    return () => {
+    let pending = new Set();
+    return (filePath) => {
+        pending.add(filePath);
         if (timer)
             clearTimeout(timer);
         timer = setTimeout(() => {
             timer = null;
-            onChange();
+            const files = [...pending].sort();
+            pending = new Set();
+            onChange(files);
         }, debounceMs);
     };
 }
 /**
  * Watch project source files — triggers hot rebuild.
- * Covers model SysML and per-project YAML config files only.
+ *
+ * The scope deliberately matches what the build ingests: every project-local
+ * `.sysml` file, wherever it sits, plus the per-project YAML config files. A
+ * narrower scope (model/ only) leaves views and catalogs outside that directory
+ * silently stale, which is exactly the class of bug this watcher exists to
+ * prevent.
+ *
+ * The callback receives the project-relative paths that changed, so callers can
+ * tell clients what moved rather than only that something did.
  */
-export function createProjectWatcher(projectDir, onChange, debounceMs = 300, usePolling = false) {
-    const fire = makeDebounced(onChange, debounceMs);
+export function createProjectWatcher(projectDir, onChange, debounceMs = 300, usePolling = false, options = {}) {
+    const fire = makeDebounced(onChange, options.debounceMs ?? debounceMs);
     const root = resolve(projectDir);
-    const modelRoot = resolve(root, 'model');
     const configFiles = [
         resolve(root, 'memo.rendering.yaml'),
         resolve(root, 'memo.rules.yaml'),
         resolve(root, 'memo.viewpoints.yaml'),
     ];
-    // Chokidar 4 removed glob support. Watch concrete roots/files and filter
-    // events instead of passing model/**/*.sysml (which silently watches none).
+    const ontologyRoots = (options.ontologyRoots ?? []).map(dir => resolve(dir));
+    /** Whether a change to this path should rebuild the project model. */
+    const isProjectSource = (absolute) => {
+        if (configFiles.includes(absolute))
+            return true;
+        if (extname(absolute).toLowerCase() !== '.sysml')
+            return false;
+        if (isInIgnoredDir(absolute))
+            return false;
+        if (!isWithin(root, absolute))
+            return false;
+        return !ontologyRoots.some(ontologyRoot => isWithin(ontologyRoot, absolute));
+    };
+    // Chokidar 4 removed glob support. Watch the project root and filter events
+    // instead of passing model/**/*.sysml (which silently watches none).
     const watcher = chokidar.watch(root, {
         ignored: (filePath, stats) => {
             const absolute = resolve(filePath);
@@ -42,25 +76,23 @@ export function createProjectWatcher(projectDir, onChange, debounceMs = 300, use
                 return false;
             if (isInIgnoredDir(absolute))
                 return true;
-            if (configFiles.includes(absolute))
+            // Directories must stay watchable — the files under them are what
+            // gets filtered, and a directory has no extension to judge by.
+            if (stats && !stats.isFile()) {
+                return ontologyRoots.some(ontologyRoot => isWithin(ontologyRoot, absolute));
+            }
+            if (!stats)
                 return false;
-            const relToModel = relative(modelRoot, absolute);
-            const inModel = relToModel !== '..' && !relToModel.startsWith(`..${sep}`);
-            if (!inModel)
-                return true;
-            return stats?.isFile() === true && extname(absolute).toLowerCase() !== '.sysml';
+            return !isProjectSource(absolute);
         },
         persistent: true,
         ignoreInitial: true,
-        usePolling,
+        usePolling: options.usePolling ?? usePolling,
     });
     watcher.on('all', (_event, filePath) => {
         const absolute = resolve(filePath);
-        const inModel = relative(modelRoot, absolute) !== '..'
-            && !relative(modelRoot, absolute).startsWith(`..${sep}`);
-        if ((inModel && extname(absolute).toLowerCase() === '.sysml') || configFiles.includes(absolute)) {
-            fire();
-        }
+        if (isProjectSource(absolute))
+            fire(relative(root, absolute));
     });
     return {
         close() { watcher.close(); },
@@ -118,7 +150,7 @@ export function createOntologyWatcher(projectDir, ontologyRoots, onChange, debou
  * Kept for backward compatibility.
  */
 export function createFileWatcher(projectDir, onChange, debounceMs = 300) {
-    const fire = makeDebounced(onChange, debounceMs);
+    const fire = makeDebounced(() => onChange(), debounceMs);
     const watchedConfigNames = new Set([
         'memo.config.yaml', 'memo.config.yml', 'memo.package.yaml',
         'memo.rendering.yaml', 'memo.rules.yaml', 'memo.viewpoints.yaml',
@@ -131,7 +163,7 @@ export function createFileWatcher(projectDir, onChange, debounceMs = 300) {
     watcher.on('all', (_event, filePath) => {
         const name = filePath.split(sep).at(-1) ?? '';
         if (extname(filePath).toLowerCase() === '.sysml' || watchedConfigNames.has(name))
-            fire();
+            fire(filePath);
     });
     return {
         close() { watcher.close(); },

package/packages/tools/lib/server/file-watcher.js.map

@@ -1 +1 @@
-{"version":3,"file":"file-watcher.js","sourceRoot":"","sources":["../../src/server/file-watcher.ts"],"names":[],"mappings":"AAAA,gFAAgF;AAChF,EAAE;AACF,+EAA+E;AAC/E,gFAAgF;AAEhF,OAAO,QAAQ,MAAM,UAAU,CAAC;AAChC,OAAO,EAAE,OAAO,EAAE,QAAQ,EAAE,OAAO,EAAE,GAAG,EAAE,MAAM,WAAW,CAAC;AAC5D,OAAO,EAAE,UAAU,EAAE,MAAM,SAAS,CAAC;AAMrC,MAAM,iBAAiB,GAAG,IAAI,GAAG,CAAC,CAAC,cAAc,EAAE,OAAO,EAAE,MAAM,EAAE,KAAK,CAAC,CAAC,CAAC;AAE5E,SAAS,cAAc,CAAC,QAAgB;IACpC,OAAO,OAAO,CAAC,QAAQ,CAAC,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,iBAAiB,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC,CAAC;AAClF,CAAC;AAED,SAAS,aAAa,CAAC,QAAoC,EAAE,UAAkB;IAC3E,IAAI,KAAK,GAAyC,IAAI,CAAC;IACvD,OAAO,GAAG,EAAE;QACR,IAAI,KAAK;YAAE,YAAY,CAAC,KAAK,CAAC,CAAC;QAC/B,KAAK,GAAG,UAAU,CAAC,GAAG,EAAE;YACpB,KAAK,GAAG,IAAI,CAAC;YACb,QAAQ,EAAE,CAAC;QACf,CAAC,EAAE,UAAU,CAAC,CAAC;IACnB,CAAC,CAAC;AACN,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,oBAAoB,CAChC,UAAkB,EAClB,QAAoC,EACpC,aAAqB,GAAG,EACxB,aAAsB,KAAK;IAE3B,MAAM,IAAI,GAAG,aAAa,CAAC,QAAQ,EAAE,UAAU,CAAC,CAAC;IAEjD,MAAM,IAAI,GAAG,OAAO,CAAC,UAAU,CAAC,CAAC;IACjC,MAAM,SAAS,GAAG,OAAO,CAAC,IAAI,EAAE,OAAO,CAAC,CAAC;IACzC,MAAM,WAAW,GAAG;QAChB,OAAO,CAAC,IAAI,EAAE,qBAAqB,CAAC;QACpC,OAAO,CAAC,IAAI,EAAE,iBAAiB,CAAC;QAChC,OAAO,CAAC,IAAI,EAAE,sBAAsB,CAAC;KACxC,CAAC;IACF,yEAAyE;IACzE,4EAA4E;IAC5E,MAAM,OAAO,GAAG,QAAQ,CAAC,KAAK,CAAC,IAAI,EAAE;QACjC,OAAO,EAAE,CAAC,QAAQ,EAAE,KAAK,EAAE,EAAE;YACzB,MAAM,QAAQ,GAAG,OAAO,CAAC,QAAQ,CAAC,CAAC;YACnC,IAAI,QAAQ,KAAK,IAAI;gBAAE,OAAO,KAAK,CAAC;YACpC,IAAI,cAAc,CAAC,QAAQ,CAAC;gBAAE,OAAO,IAAI,CAAC;YAC1C,IAAI,WAAW,CAAC,QAAQ,CAAC,QAAQ,CAAC;gBAAE,OAAO,KAAK,CAAC;YAEjD,MAAM,UAAU,GAAG,QAAQ,CAAC,SAAS,EAAE,QAAQ,CAAC,CAAC;YACjD,MAAM,OAAO,GAAG,UAAU,KAAK,IAAI,IAAI,CAAC,UAAU,CAAC,UAAU,CAAC,KAAK,GAAG,EAAE,CAAC,CAAC;YAC1E,IAAI,CAAC,OAAO;gBAAE,OAAO,IAAI,CAAC;YAC1B,OAAO,KAAK,EAAE,MAAM,EAAE,KAAK,IAAI,IAAI,OAAO,CAAC,QAAQ,CAAC,CAAC,WAAW,EAAE,KAAK,QAAQ,CAAC;QACpF,CAAC;QACD,UAAU,EAAE,IAAI;QAChB,aAAa,EAAE,IAAI;QACnB,UAAU;KACb,CAAC,CAAC;IAEH,OAAO,CAAC,EAAE,CAAC,KAAK,EAAE,CAAC,MAAM,EAAE,QAAQ,EAAE,EAAE;QACnC,MAAM,QAAQ,GAAG,OAAO,CAAC,QAAQ,CAAC,CAAC;QACnC,MAAM,OAAO,GAAG,QAAQ,CAAC,SAAS,EAAE,QAAQ,CAAC,KAAK,IAAI;eAC/C,CAAC,QAAQ,CAAC,SAAS,EAAE,QAAQ,CAAC,CAAC,UAAU,CAAC,KAAK,GAAG,EAAE,CAAC,CAAC;QAC7D,IAAI,CAAC,OAAO,IAAI,OAAO,CAAC,QAAQ,CAAC,CAAC,WAAW,EAAE,KAAK,QAAQ,CAAC,IAAI,WAAW,CAAC,QAAQ,CAAC,QAAQ,CAAC,EAAE,CAAC;YAC9F,IAAI,EAAE,CAAC;QACX,CAAC;IACL,CAAC,CAAC,CAAC;IAEH,OAAO;QACH,KAAK,KAAK,OAAO,CAAC,KAAK,EAAE,CAAC,CAAC,CAAC;KAC/B,CAAC;AACN,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,qBAAqB,CACjC,UAAkB,EAClB,aAAuB,EACvB,QAAuD,EACvD,aAAqB,GAAG;IAExB,IAAI,KAAK,GAAyC,IAAI,CAAC;IACvD,IAAI,WAAW,GAAG,EAAE,CAAC;IAErB,MAAM,IAAI,GAAG,CAAC,QAAgB,EAAE,EAAE;QAC9B,IAAI,CAAC,WAAW;YAAE,WAAW,GAAG,QAAQ,CAAC;QACzC,IAAI,KAAK;YAAE,YAAY,CAAC,KAAK,CAAC,CAAC;QAC/B,KAAK,GAAG,UAAU,CAAC,GAAG,EAAE;YACpB,KAAK,GAAG,IAAI,CAAC;YACb,MAAM,CAAC,GAAG,WAAW,CAAC;YACtB,WAAW,GAAG,EAAE,CAAC;YACjB,QAAQ,CAAC,CAAC,CAAC,CAAC;QAChB,CAAC,EAAE,UAAU,CAAC,CAAC;IACnB,CAAC,CAAC;IAEF,MAAM,KAAK,GAAa;QACpB,wDAAwD;QACxD,GAAG,aAAa,CAAC,OAAO,CAAC,IAAI,CAAC,EAAE,CAAC;YAC7B,OAAO,CAAC,IAAI,EAAE,OAAO,CAAC;YACtB,OAAO,CAAC,IAAI,EAAE,mBAAmB,CAAC;YAClC,OAAO,CAAC,IAAI,EAAE,qBAAqB,CAAC;SACvC,CAAC;QACF,mCAAmC;QACnC,OAAO,CAAC,UAAU,EAAE,kBAAkB,CAAC;QACvC,OAAO,CAAC,UAAU,EAAE,iBAAiB,CAAC;QACtC,OAAO,CAAC,UAAU,EAAE,mBAAmB,CAAC;QACxC,OAAO,CAAC,UAAU,EAAE,OAAO,EAAE,0BAA0B,CAAC;KAC3D,CAAC;IAEF,MAAM,OAAO,GAAG,QAAQ,CAAC,KAAK,CAAC,KAAK,CAAC,MAAM,CAAC,UAAU,CAAC,EAAE;QACrD,OAAO,EAAE,QAAQ,CAAC,EAAE,CAAC,cAAc,CAAC,QAAQ,CAAC;QAC7C,UAAU,EAAE,IAAI;QAChB,aAAa,EAAE,IAAI;KACtB,CAAC,CAAC;IAEH,OAAO,CAAC,EAAE,CAAC,KAAK,EAAE,CAAC,MAAM,EAAE,QAAQ,EAAE,EAAE,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC,CAAC;IAExD,OAAO;QACH,KAAK;YACD,IAAI,KAAK;gBAAE,YAAY,CAAC,KAAK,CAAC,CAAC;YAC/B,OAAO,CAAC,KAAK,EAAE,CAAC;QACpB,CAAC;KACJ,CAAC;AACN,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,iBAAiB,CAC7B,UAAkB,EAClB,QAAoC,EACpC,aAAqB,GAAG;IAExB,MAAM,IAAI,GAAG,aAAa,CAAC,QAAQ,EAAE,UAAU,CAAC,CAAC;IAEjD,MAAM,kBAAkB,GAAG,IAAI,GAAG,CAAC;QAC/B,kBAAkB,EAAE,iBAAiB,EAAE,mBAAmB;QAC1D,qBAAqB,EAAE,iBAAiB,EAAE,sBAAsB;KACnE,CAAC,CAAC;IACH,MAAM,OAAO,GAAG,QAAQ,CAAC,KAAK,CAAC,OAAO,CAAC,UAAU,CAAC,EAAE;QAChD,OAAO,EAAE,QAAQ,CAAC,EAAE,CAAC,cAAc,CAAC,QAAQ,CAAC;QAC7C,UAAU,EAAE,IAAI;QAChB,aAAa,EAAE,IAAI;KACtB,CAAC,CAAC;IAEH,OAAO,CAAC,EAAE,CAAC,KAAK,EAAE,CAAC,MAAM,EAAE,QAAQ,EAAE,EAAE;QACnC,MAAM,IAAI,GAAG,QAAQ,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC;QAC9C,IAAI,OAAO,CAAC,QAAQ,CAAC,CAAC,WAAW,EAAE,KAAK,QAAQ,IAAI,kBAAkB,CAAC,GAAG,CAAC,IAAI,CAAC;YAAE,IAAI,EAAE,CAAC;IAC7F,CAAC,CAAC,CAAC;IAEH,OAAO;QACH,KAAK,KAAK,OAAO,CAAC,KAAK,EAAE,CAAC,CAAC,CAAC;KAC/B,CAAC;AACN,CAAC"}
+{"version":3,"file":"file-watcher.js","sourceRoot":"","sources":["../../src/server/file-watcher.ts"],"names":[],"mappings":"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"}

package/packages/tools/lib/server/persistor.d.ts

@@ -9,17 +9,4 @@ export declare function saveElementToFile(cwd: string, element: any): {
     filePath: string;
     error?: string;
 };
-/**
- * Appends a typed relationship connection to model/relationships.sysml.
- * Writes:  connection : RelType connect sourceId to targetId;
- */
-export declare function saveRelationshipToFile(cwd: string, rel: {
-    sourceId: string;
-    targetId: string;
-    type: string;
-}): {
-    success: boolean;
-    filePath: string;
-    error?: string;
-};
 //# sourceMappingURL=persistor.d.ts.map

package/packages/tools/lib/server/persistor.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"persistor.d.ts","sourceRoot":"","sources":["../../src/server/persistor.ts"],"names":[],"mappings":"AAIA;;;;;GAKG;AACH,wBAAgB,iBAAiB,CAAC,GAAG,EAAE,MAAM,EAAE,OAAO,EAAE,GAAG,GAAG;IAAE,OAAO,EAAE,OAAO,CAAC;IAAC,QAAQ,EAAE,MAAM,CAAC;IAAC,KAAK,CAAC,EAAE,MAAM,CAAA;CAAE,CAmEnH;AAED;;;GAGG;AACH,wBAAgB,sBAAsB,CAClC,GAAG,EAAE,MAAM,EACX,GAAG,EAAE;IAAE,QAAQ,EAAE,MAAM,CAAC;IAAC,QAAQ,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,CAAA;CAAE,GAC1D;IAAE,OAAO,EAAE,OAAO,CAAC;IAAC,QAAQ,EAAE,MAAM,CAAC;IAAC,KAAK,CAAC,EAAE,MAAM,CAAA;CAAE,CA0BxD"}
+{"version":3,"file":"persistor.d.ts","sourceRoot":"","sources":["../../src/server/persistor.ts"],"names":[],"mappings":"AAIA;;;;;GAKG;AACH,wBAAgB,iBAAiB,CAAC,GAAG,EAAE,MAAM,EAAE,OAAO,EAAE,GAAG,GAAG;IAAE,OAAO,EAAE,OAAO,CAAC;IAAC,QAAQ,EAAE,MAAM,CAAC;IAAC,KAAK,CAAC,EAAE,MAAM,CAAA;CAAE,CAmEnH"}

package/packages/tools/lib/server/persistor.js

@@ -66,35 +66,7 @@ export function saveElementToFile(cwd, element) {
         return { success: false, filePath: relativePath, error: String(e) };
     }
 }
-/**
- * Appends a typed relationship connection to model/relationships.sysml.
- * Writes:  connection : RelType connect sourceId to targetId;
- */
-export function saveRelationshipToFile(cwd, rel) {
-    const relativePath = 'model/relationships.sysml';
-    const filePath = resolve(cwd, relativePath);
-    const dir = dirname(filePath);
-    if (!existsSync(dir))
-        mkdirSync(dir, { recursive: true });
-    const typeName = rel.type.charAt(0).toUpperCase() + rel.type.slice(1);
-    const line = `    connection : ${typeName} connect ${rel.sourceId} to ${rel.targetId};\n`;
-    try {
-        if (!existsSync(filePath)) {
-            writeFileSync(filePath, `package relationships {\n${line}}\n`, 'utf8');
-        }
-        else {
-            // Insert before the last closing brace
-            const content = readFileSync(filePath, 'utf8');
-            const lastBrace = content.lastIndexOf('}');
-            const newContent = lastBrace !== -1
-                ? content.slice(0, lastBrace) + line + content.slice(lastBrace)
-                : content + line;
-            writeFileSync(filePath, newContent, 'utf8');
-        }
-        return { success: true, filePath: relativePath };
-    }
-    catch (e) {
-        return { success: false, filePath: relativePath, error: String(e) };
-    }
-}
+// Relationship persistence lives in ./relationship-writer.ts. It replaces the
+// blind append this module used to do: relationships now go through ontology
+// validation, a deterministic ownership policy, and CST-aware source editing.
 //# sourceMappingURL=persistor.js.map

package/packages/tools/lib/server/persistor.js.map

@@ -1 +1 @@
-{"version":3,"file":"persistor.js","sourceRoot":"","sources":["../../src/server/persistor.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,aAAa,EAAE,UAAU,EAAE,cAAc,EAAE,SAAS,EAAE,MAAM,SAAS,CAAC;AAC7F,OAAO,EAAE,OAAO,EAAE,OAAO,EAAQ,MAAM,WAAW,CAAC;AACnD,OAAO,EAAE,aAAa,EAAoB,MAAM,sBAAsB,CAAC;AAEvE;;;;;GAKG;AACH,MAAM,UAAU,iBAAiB,CAAC,GAAW,EAAE,OAAY;IACvD,MAAM,YAAY,GAAG,OAAO,CAAC,IAAI,IAAI,uBAAuB,CAAC;IAC7D,MAAM,QAAQ,GAAG,OAAO,CAAC,GAAG,EAAE,YAAY,CAAC,CAAC;IAE5C,6BAA6B;IAC7B,MAAM,GAAG,GAAG,OAAO,CAAC,QAAQ,CAAC,CAAC;IAC9B,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC,EAAE,CAAC;QACnB,SAAS,CAAC,GAAG,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;IACxC,CAAC;IAED,4BAA4B;IAC5B,IAAI,CAAC,UAAU,CAAC,QAAQ,CAAC,EAAE,CAAC;QACxB,MAAM,OAAO,GAAG,YAAY,CAAC,OAAO,CAAC,eAAe,EAAE,GAAG,CAAC,CAAC,OAAO,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC,OAAO,CAAC,UAAU,EAAE,EAAE,CAAC,CAAC;QACrG,aAAa,CAAC,QAAQ,EAAE,WAAW,OAAO,IAAI,WAAW,SAAS,EAAE,MAAM,CAAC,CAAC;IAChF,CAAC;IAED,MAAM,OAAO,GAAG,YAAY,CAAC,QAAQ,EAAE,MAAM,CAAC,CAAC;IAE/C,oDAAoD;IACpD,iFAAiF;IACjF,4BAA4B;IAC5B,MAAM,QAAQ,GAAG,aAAa,CAAC;QAC3B,EAAE,EAAE,OAAO,CAAC,EAAE;QACd,IAAI,EAAE,OAAO,CAAC,IAAI;QAClB,IAAI,EAAE,OAAO,CAAC,IAAI;QAClB,SAAS,EAAE,OAAO,CAAC,SAAS,IAAI,MAAM;QACtC,KAAK,EAAE,OAAO,CAAC,KAAK,IAAI,EAAE;QAC1B,GAAG,EAAE,OAAO,CAAC,GAAG,IAAI,EAAE;QACtB,UAAU,EAAE,OAAO,CAAC,UAAU,IAAI,EAAE;KACvC,CAAC,CAAC;IAEH,gCAAgC;IAChC,0DAA0D;IAC1D,MAAM,SAAS,GAAG,OAAO,CAAC,EAAE,CAAC,OAAO,CAAC,qBAAqB,EAAE,MAAM,CAAC,CAAC;IACpE,MAAM,UAAU,GAAG,IAAI,MAAM,CACzB,aAAa,SAAS,gDAAgD,EACtE,GAAG,CACN,CAAC;IAEF,MAAM,OAAO,GAAG,OAAO,CAAC,KAAK,CAAC,UAAU,CAAC,CAAC;IAC1C,IAAI,UAAkB,CAAC;IAEvB,MAAM,GAAG,GAAG,CAAC,GAAW,EAAE,EAAE,CAAC,cAAc,CAAC,oBAAoB,EAAE,IAAI,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE,KAAK,GAAG,IAAI,CAAC,CAAC;IAC5G,GAAG,CAAC,cAAc,OAAO,CAAC,EAAE,OAAO,QAAQ,kBAAkB,OAAO,CAAC,MAAM,EAAE,CAAC,CAAC;IAE/E,IAAI,OAAO,EAAE,CAAC;QACV,GAAG,CAAC,oCAAoC,OAAO,CAAC,EAAE,qBAAqB,OAAO,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,EAAE,EAAE,CAAC,KAAK,CAAC,CAAC;QACrG,UAAU,GAAG,OAAO,CAAC,OAAO,CAAC,UAAU,EAAE,QAAQ,CAAC,CAAC;IACvD,CAAC;SAAM,CAAC;QACJ,GAAG,CAAC,oCAAoC,OAAO,CAAC,EAAE,iEAAiE,CAAC,CAAC;QACrH,MAAM,SAAS,GAAG,OAAO,CAAC,WAAW,CAAC,GAAG,CAAC,CAAC;QAC3C,IAAI,SAAS,KAAK,CAAC,CAAC,EAAE,CAAC;YACnB,MAAM,aAAa,GAAG,QAAQ,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;YAC3E,UAAU,GAAG,OAAO,CAAC,KAAK,CAAC,CAAC,EAAE,SAAS,CAAC,GAAG,IAAI,GAAG,aAAa,GAAG,IAAI,GAAG,OAAO,CAAC,KAAK,CAAC,SAAS,CAAC,CAAC;QACtG,CAAC;aAAM,CAAC;YACJ,UAAU,GAAG,OAAO,GAAG,IAAI,GAAG,QAAQ,GAAG,IAAI,CAAC;QAClD,CAAC;IACL,CAAC;IAED,IAAI,CAAC;QACD,aAAa,CAAC,QAAQ,EAAE,UAAU,EAAE,MAAM,CAAC,CAAC;QAC5C,GAAG,CAAC,sBAAsB,UAAU,CAAC,MAAM,aAAa,QAAQ,EAAE,CAAC,CAAC;QACpE,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,QAAQ,EAAE,YAAY,EAAE,CAAC;IACrD,CAAC;IAAC,OAAO,CAAC,EAAE,CAAC;QACT,GAAG,CAAC,gCAAgC,QAAQ,KAAK,CAAC,EAAE,CAAC,CAAC;QACtD,OAAO,EAAE,OAAO,EAAE,KAAK,EAAE,QAAQ,EAAE,YAAY,EAAE,KAAK,EAAE,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC;IACxE,CAAC;AACL,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,sBAAsB,CAClC,GAAW,EACX,GAAyD;IAEzD,MAAM,YAAY,GAAG,2BAA2B,CAAC;IACjD,MAAM,QAAQ,GAAG,OAAO,CAAC,GAAG,EAAE,YAAY,CAAC,CAAC;IAC5C,MAAM,GAAG,GAAG,OAAO,CAAC,QAAQ,CAAC,CAAC;IAE9B,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC;QAAE,SAAS,CAAC,GAAG,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;IAE1D,MAAM,QAAQ,GAAG,GAAG,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,WAAW,EAAE,GAAG,GAAG,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC;IACtE,MAAM,IAAI,GAAG,oBAAoB,QAAQ,YAAY,GAAG,CAAC,QAAQ,OAAO,GAAG,CAAC,QAAQ,KAAK,CAAC;IAE1F,IAAI,CAAC;QACD,IAAI,CAAC,UAAU,CAAC,QAAQ,CAAC,EAAE,CAAC;YACxB,aAAa,CAAC,QAAQ,EAAE,4BAA4B,IAAI,KAAK,EAAE,MAAM,CAAC,CAAC;QAC3E,CAAC;aAAM,CAAC;YACJ,uCAAuC;YACvC,MAAM,OAAO,GAAG,YAAY,CAAC,QAAQ,EAAE,MAAM,CAAC,CAAC;YAC/C,MAAM,SAAS,GAAG,OAAO,CAAC,WAAW,CAAC,GAAG,CAAC,CAAC;YAC3C,MAAM,UAAU,GAAG,SAAS,KAAK,CAAC,CAAC;gBAC/B,CAAC,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC,EAAE,SAAS,CAAC,GAAG,IAAI,GAAG,OAAO,CAAC,KAAK,CAAC,SAAS,CAAC;gBAC/D,CAAC,CAAC,OAAO,GAAG,IAAI,CAAC;YACrB,aAAa,CAAC,QAAQ,EAAE,UAAU,EAAE,MAAM,CAAC,CAAC;QAChD,CAAC;QACD,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,QAAQ,EAAE,YAAY,EAAE,CAAC;IACrD,CAAC;IAAC,OAAO,CAAC,EAAE,CAAC;QACT,OAAO,EAAE,OAAO,EAAE,KAAK,EAAE,QAAQ,EAAE,YAAY,EAAE,KAAK,EAAE,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC;IACxE,CAAC;AACL,CAAC"}
+{"version":3,"file":"persistor.js","sourceRoot":"","sources":["../../src/server/persistor.ts"],"names":[],"mappings":"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"}

package/packages/tools/lib/server/relationship-writer.d.ts

@@ -0,0 +1,104 @@
+import type { MemoModelDTO, MemoRelationship } from '../model/semantic.js';
+import type { RelationshipCreateRequest, RelationshipDefinitionDTO } from '../model/relationship-legality.js';
+/** Default file used when the project has no better home for a relationship. */
+export declare const CANONICAL_RELATIONSHIP_FILE = "model/relationships.sysml";
+/** Directory segments holding view/presentation SysML — never a relationship home. */
+export declare const DEFAULT_PRESENTATION_DIRS: string[];
+/** Filenames a package uses to collect its relationships. */
+export declare const DEFAULT_RELATIONSHIP_FILE_PATTERN: RegExp;
+export interface RelationshipWriterOptions {
+    /** Absolute project root. Nothing outside it is ever written. */
+    projectRoot: string;
+    /**
+     * Per-package designated relationship files, project-relative.
+     * Keyed by package qualified name, from project configuration.
+     */
+    designatedFiles?: Record<string, string>;
+    /** Configured canonical relationship file, project-relative. */
+    canonicalFile?: string;
+    /**
+     * Absolute roots of installed ontology/library packages. Files under these
+     * are read-only content and are never modified.
+     */
+    ontologyRoots?: string[];
+    /**
+     * Directory segments that hold view/presentation SysML. A relationship is a
+     * model fact and is never written into one.
+     */
+    presentationDirs?: string[];
+    /** Filenames treated as a package's relationship collection. */
+    relationshipFilePattern?: RegExp;
+}
+/** Why a particular file was chosen, for logging and for the UI to show. */
+export type PlacementReason = 'requested' | 'designated-package-file' | 'common-package-file' | 'source-element-file' | 'canonical-file' | 'canonical-file-created';
+export interface RelationshipPlacement {
+    /** Project-relative .sysml path that will own the relationship. */
+    file: string;
+    reason: PlacementReason;
+    /** True when the file does not exist yet and will be created. */
+    willCreate: boolean;
+}
+export interface RelationshipWriteResult {
+    success: boolean;
+    /** Project-relative file actually written. */
+    sourceFile?: string;
+    /** Stable ID (the connection usage name) of the created relationship. */
+    relationshipId?: string;
+    /** The exact declaration text inserted. */
+    declaration?: string;
+    placementReason?: PlacementReason;
+    error?: string;
+}
+export interface RelationshipRemoveResult {
+    success: boolean;
+    sourceFile?: string;
+    /** The declaration removed, so the caller can offer an exact undo. */
+    removedDeclaration?: string;
+    error?: string;
+}
+/**
+ * Whether a project-relative path is a legal home for a model relationship.
+ *
+ * Rejects anything outside the project, non-.sysml files, installed ontology
+ * content, and the diagram presentation section. Symlinks are resolved before
+ * the containment check so an in-tree link cannot escape the project.
+ */
+export declare function isWritableRelationshipFile(relativePath: string, options: RelationshipWriterOptions): boolean;
+/**
+ * Choose the file that will own a new relationship, deterministically:
+ *
+ *   1. the file the request explicitly asked for
+ *   2. the designated relationship file of the active model package
+ *   3. an existing relationships file in the nearest common package of both
+ *      endpoints, else the source element's own file within that package
+ *   4. the configured canonical relationship file, when it already exists
+ *   5. the canonical file, created only because nothing above was suitable
+ *
+ * Every candidate passes isWritableRelationshipFile before it is considered.
+ */
+export declare function resolveRelationshipPlacement(request: Pick<RelationshipCreateRequest, 'sourceId' | 'targetId' | 'owningFile'>, model: Pick<MemoModelDTO, 'elements'>, options: RelationshipWriterOptions): RelationshipPlacement;
+/**
+ * A stable, explicit relationship ID. Named connection usages are what make a
+ * relationship addressable for inspection, deletion, and deep links, so every
+ * authored relationship gets one.
+ */
+export declare function generateRelationshipId(type: string, sourceId: string, targetId: string, taken: Iterable<string>): string;
+/** Render the typed connection usage for a relationship. */
+export declare function generateRelationshipDeclaration(id: string, definition: RelationshipDefinitionDTO, sourceId: string, targetId: string): string;
+/**
+ * Write a relationship into project SysML.
+ *
+ * The declaration is inserted inside the target package by source offset, the
+ * whole updated file is reparsed, and the write is abandoned if the result does
+ * not parse or does not contain the new connection.
+ */
+export declare function writeRelationship(request: RelationshipCreateRequest, definition: RelationshipDefinitionDTO, model: Pick<MemoModelDTO, 'elements' | 'relationships'>, options: RelationshipWriterOptions): Promise<RelationshipWriteResult>;
+/**
+ * Remove exactly one connection usage from its owning file.
+ *
+ * Only the declaration's own source range is cut — together with the whitespace
+ * on its line — so neighbouring comments and declarations are preserved. Both
+ * endpoint elements are left completely untouched.
+ */
+export declare function removeRelationship(relationship: Pick<MemoRelationship, 'id' | 'file' | 'named'>, options: RelationshipWriterOptions): Promise<RelationshipRemoveResult>;
+//# sourceMappingURL=relationship-writer.d.ts.map

package/packages/tools/lib/server/relationship-writer.d.ts.map

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