@living-architecture/riviere-cli 0.4.3 → 0.4.5

package/dist/bin.js

@@ -2041,38 +2041,28 @@ var require_fast_deep_equal = __commonJS({
   "../../node_modules/.pnpm/fast-deep-equal@3.1.3/node_modules/fast-deep-equal/index.js"(exports, module) {
     "use strict";
     module.exports = function equal(a, b) {
-      if (a === b)
-        return true;
+      if (a === b) return true;
       if (a && b && typeof a == "object" && typeof b == "object") {
-        if (a.constructor !== b.constructor)
-          return false;
+        if (a.constructor !== b.constructor) return false;
         var length, i, keys;
         if (Array.isArray(a)) {
           length = a.length;
-          if (length != b.length)
-            return false;
+          if (length != b.length) return false;
           for (i = length; i-- !== 0; )
-            if (!equal(a[i], b[i]))
-              return false;
+            if (!equal(a[i], b[i])) return false;
           return true;
         }
-        if (a.constructor === RegExp)
-          return a.source === b.source && a.flags === b.flags;
-        if (a.valueOf !== Object.prototype.valueOf)
-          return a.valueOf() === b.valueOf();
-        if (a.toString !== Object.prototype.toString)
-          return a.toString() === b.toString();
+        if (a.constructor === RegExp) return a.source === b.source && a.flags === b.flags;
+        if (a.valueOf !== Object.prototype.valueOf) return a.valueOf() === b.valueOf();
+        if (a.toString !== Object.prototype.toString) return a.toString() === b.toString();
         keys = Object.keys(a);
         length = keys.length;
-        if (length !== Object.keys(b).length)
-          return false;
+        if (length !== Object.keys(b).length) return false;
         for (i = length; i-- !== 0; )
-          if (!Object.prototype.hasOwnProperty.call(b, keys[i]))
-            return false;
+          if (!Object.prototype.hasOwnProperty.call(b, keys[i])) return false;
         for (i = length; i-- !== 0; ) {
           var key = keys[i];
-          if (!equal(a[key], b[key]))
-            return false;
+          if (!equal(a[key], b[key])) return false;
         }
         return true;
       }
@@ -3228,8 +3218,7 @@ var require_utils = __commonJS({
     function findToken(str, token) {
       let ind = 0;
       for (let i = 0; i < str.length; i++) {
-        if (str[i] === token)
-          ind++;
+        if (str[i] === token) ind++;
       }
       return ind;
     }
@@ -3687,8 +3676,7 @@ var require_fast_uri = __commonJS({
       const options = Object.assign({}, opts);
       const uriTokens = [];
       const schemeHandler = getSchemeHandler(options.scheme || component.scheme);
-      if (schemeHandler && schemeHandler.serialize)
-        schemeHandler.serialize(component, options);
+      if (schemeHandler && schemeHandler.serialize) schemeHandler.serialize(component, options);
       if (component.path !== void 0) {
         if (!options.skipEscape) {
           component.path = escape(component.path);
@@ -21104,10 +21092,10 @@ function queryEntities(graph, domainName) {
   for (const op of filtered) {
     const key = `${op.domain}:${op.entity}`;
     const existing = entityMap.get(key);
-    if (existing !== void 0) {
-      entityMap.set(key, { ...existing, operations: [...existing.operations, op] });
-    } else {
+    if (existing === void 0) {
       entityMap.set(key, { name: op.entity, domain: op.domain, operations: [op] });
+    } else {
+      entityMap.set(key, { ...existing, operations: [...existing.operations, op] });
     }
   }
   return Array.from(entityMap.values()).sort((a, b) => a.name.localeCompare(b.name)).map((partial2) => createEntity(graph, partial2));
@@ -21297,7 +21285,7 @@ function queryFlows(graph) {
         return;
       const edges = outgoingEdges.get(nodeId);
       const firstEdge = edges !== void 0 && edges.length > 0 ? edges[0] : void 0;
-      const linkType = firstEdge !== void 0 ? firstEdge.type : void 0;
+      const linkType = firstEdge === void 0 ? void 0 : firstEdge.type;
       const externalLinks = externalLinksBySource.get(nodeId) ?? [];
       steps.push({ component, linkType, depth, externalLinks });
       if (edges) {
@@ -22881,6 +22869,9 @@ var RiviereBuilder = class _RiviereBuilder {
     if (enrichment.behavior !== void 0) {
       component.behavior = mergeBehavior(component.behavior, enrichment.behavior);
     }
+    if (enrichment.signature !== void 0) {
+      component.signature = enrichment.signature;
+    }
   }
   componentNotFoundError(id) {
     return createSourceNotFoundError(this.graph.components, ComponentId.parse(id));
@@ -24060,6 +24051,65 @@ function buildBehavior(options) {
     }
   };
 }
+function parseParameter(input) {
+  const parts = input.split(":");
+  if (parts.length < 2 || parts.length > 3) {
+    return void 0;
+  }
+  const [name, type, description] = parts;
+  if (name === void 0 || name === "" || type === void 0 || type === "") {
+    return void 0;
+  }
+  return {
+    name: name.trim(),
+    type: type.trim(),
+    ...description !== void 0 && description !== "" && { description: description.trim() }
+  };
+}
+function parseParameters(paramsPart) {
+  if (paramsPart === "") {
+    return { success: true, parameters: [] };
+  }
+  const paramStrings = paramsPart.split(",").map((p) => p.trim());
+  const parameters = [];
+  for (const paramStr of paramStrings) {
+    const param = parseParameter(paramStr);
+    if (param === void 0) {
+      return { success: false, error: `Invalid parameter format: '${paramStr}'. Expected 'name:type' or 'name:type:description'.` };
+    }
+    parameters.push(param);
+  }
+  return { success: true, parameters };
+}
+function buildSignatureObject(parameters, returnType) {
+  const signature = {};
+  if (parameters.length > 0) {
+    signature.parameters = parameters;
+  }
+  if (returnType !== void 0 && returnType !== "") {
+    signature.returnType = returnType;
+  }
+  return signature;
+}
+function parseSignature(input) {
+  const trimmed = input.trim();
+  if (trimmed.startsWith("->")) {
+    const returnType2 = trimmed.slice(2).trim();
+    return returnType2 === "" ? { success: false, error: `Invalid signature format: '${input}'. Return type cannot be empty.` } : { success: true, signature: { returnType: returnType2 } };
+  }
+  const arrowIndex = trimmed.indexOf(" -> ");
+  const paramsPart = arrowIndex === -1 ? trimmed : trimmed.slice(0, arrowIndex).trim();
+  const returnType = arrowIndex === -1 ? void 0 : trimmed.slice(arrowIndex + 4).trim();
+  const paramsResult = parseParameters(paramsPart);
+  if (!paramsResult.success) {
+    return paramsResult;
+  }
+  const signature = buildSignatureObject(paramsResult.parameters, returnType);
+  if (paramsResult.parameters.length === 0 && returnType === void 0) {
+    return { success: false, error: `Invalid signature format: '${input}'. Expected 'param:type, ... -> ReturnType' or '-> ReturnType' or 'param:type'.` };
+  }
+  return { success: true, signature };
+}
 function handleEnrichmentError(error46) {
   if (error46 instanceof InvalidEnrichmentTargetError) {
     console.log(JSON.stringify(formatError2("INVALID_COMPONENT_TYPE" /* InvalidComponentType */, error46.message, [])));
@@ -24091,20 +24141,27 @@ Examples:
       --validates "amount > 0" \\
       --modifies "this.status <- Processing"
 `
-  ).requiredOption("--id <component-id>", "Component ID to enrich").option("--entity <name>", "Entity name").option("--state-change <from:to>", "State transition (repeatable)", collectOption, []).option("--business-rule <rule>", "Business rule (repeatable)", collectOption, []).option("--reads <value>", "What the operation reads (repeatable)", collectOption, []).option("--validates <value>", "What the operation validates (repeatable)", collectOption, []).option("--modifies <value>", "What the operation modifies (repeatable)", collectOption, []).option("--emits <value>", "What the operation emits (repeatable)", collectOption, []).option("--graph <path>", getDefaultGraphPathDescription()).option("--json", "Output result as JSON").action(async (options) => {
+  ).requiredOption("--id <component-id>", "Component ID to enrich").option("--entity <name>", "Entity name").option("--state-change <from:to>", "State transition (repeatable)", collectOption, []).option("--business-rule <rule>", "Business rule (repeatable)", collectOption, []).option("--reads <value>", "What the operation reads (repeatable)", collectOption, []).option("--validates <value>", "What the operation validates (repeatable)", collectOption, []).option("--modifies <value>", "What the operation modifies (repeatable)", collectOption, []).option("--emits <value>", "What the operation emits (repeatable)", collectOption, []).option("--signature <dsl>", 'Operation signature (e.g., "orderId:string, amount:number -> Order")').option("--graph <path>", getDefaultGraphPathDescription()).option("--json", "Output result as JSON").action(async (options) => {
     const parseResult = parseStateChanges(options.stateChange);
     if (!parseResult.success) {
       const msg = `Invalid state-change format: '${parseResult.invalidInput}'. Expected 'from:to'.`;
       console.log(JSON.stringify(formatError2("VALIDATION_ERROR" /* ValidationError */, msg, [])));
       return;
     }
+    const signatureResult = options.signature === void 0 ? void 0 : parseSignature(options.signature);
+    if (signatureResult !== void 0 && !signatureResult.success) {
+      console.log(JSON.stringify(formatError2("VALIDATION_ERROR" /* ValidationError */, signatureResult.error, [])));
+      return;
+    }
+    const parsedSignature = signatureResult?.success === true ? signatureResult.signature : void 0;
     await withGraphBuilder(options.graph, async (builder, graphPath) => {
       try {
         builder.enrichComponent(options.id, {
           ...options.entity !== void 0 && { entity: options.entity },
           ...parseResult.stateChanges.length > 0 && { stateChanges: parseResult.stateChanges },
           ...options.businessRule.length > 0 && { businessRules: options.businessRule },
-          ...buildBehavior(options)
+          ...buildBehavior(options),
+          ...parsedSignature !== void 0 && { signature: parsedSignature }
         });
       } catch (error46) {
         handleEnrichmentError(error46);
@@ -24162,7 +24219,7 @@ Examples:
     }
     await withGraphBuilder(options.graph, async (builder) => {
       const allComponents = builder.query().components();
-      const filteredComponents = options.type !== void 0 ? allComponents.filter((c) => c.type === options.type) : allComponents;
+      const filteredComponents = options.type === void 0 ? allComponents : allComponents.filter((c) => c.type === options.type);
       const checklistItems = filteredComponents.map((c) => ({
         id: c.id,
         type: c.type,
@@ -24470,9 +24527,9 @@ Examples:
     }
     await withGraph(options.graph, (query) => {
       const allComponents = query.components();
-      const filteredByDomain = options.domain !== void 0 ? allComponents.filter((c) => c.domain === options.domain) : allComponents;
-      const typeFilter = options.type !== void 0 ? normalizeToSchemaComponentType(options.type) : void 0;
-      const filteredByType = typeFilter !== void 0 ? filteredByDomain.filter((c) => c.type === typeFilter) : filteredByDomain;
+      const filteredByDomain = options.domain === void 0 ? allComponents : allComponents.filter((c) => c.domain === options.domain);
+      const typeFilter = options.type === void 0 ? void 0 : normalizeToSchemaComponentType(options.type);
+      const filteredByType = typeFilter === void 0 ? filteredByDomain : filteredByDomain.filter((c) => c.type === typeFilter);
       const components = filteredByType.map(toComponentOutput);
       if (options.json) {
         console.log(JSON.stringify(formatSuccess({ components })));

package/dist/index.js

@@ -2040,38 +2040,28 @@ var require_fast_deep_equal = __commonJS({
   "../../node_modules/.pnpm/fast-deep-equal@3.1.3/node_modules/fast-deep-equal/index.js"(exports, module) {
     "use strict";
     module.exports = function equal(a, b) {
-      if (a === b)
-        return true;
+      if (a === b) return true;
       if (a && b && typeof a == "object" && typeof b == "object") {
-        if (a.constructor !== b.constructor)
-          return false;
+        if (a.constructor !== b.constructor) return false;
         var length, i, keys;
         if (Array.isArray(a)) {
           length = a.length;
-          if (length != b.length)
-            return false;
+          if (length != b.length) return false;
           for (i = length; i-- !== 0; )
-            if (!equal(a[i], b[i]))
-              return false;
+            if (!equal(a[i], b[i])) return false;
           return true;
         }
-        if (a.constructor === RegExp)
-          return a.source === b.source && a.flags === b.flags;
-        if (a.valueOf !== Object.prototype.valueOf)
-          return a.valueOf() === b.valueOf();
-        if (a.toString !== Object.prototype.toString)
-          return a.toString() === b.toString();
+        if (a.constructor === RegExp) return a.source === b.source && a.flags === b.flags;
+        if (a.valueOf !== Object.prototype.valueOf) return a.valueOf() === b.valueOf();
+        if (a.toString !== Object.prototype.toString) return a.toString() === b.toString();
         keys = Object.keys(a);
         length = keys.length;
-        if (length !== Object.keys(b).length)
-          return false;
+        if (length !== Object.keys(b).length) return false;
         for (i = length; i-- !== 0; )
-          if (!Object.prototype.hasOwnProperty.call(b, keys[i]))
-            return false;
+          if (!Object.prototype.hasOwnProperty.call(b, keys[i])) return false;
         for (i = length; i-- !== 0; ) {
           var key = keys[i];
-          if (!equal(a[key], b[key]))
-            return false;
+          if (!equal(a[key], b[key])) return false;
         }
         return true;
       }
@@ -3227,8 +3217,7 @@ var require_utils = __commonJS({
     function findToken(str, token) {
       let ind = 0;
       for (let i = 0; i < str.length; i++) {
-        if (str[i] === token)
-          ind++;
+        if (str[i] === token) ind++;
       }
       return ind;
     }
@@ -3686,8 +3675,7 @@ var require_fast_uri = __commonJS({
       const options = Object.assign({}, opts);
       const uriTokens = [];
       const schemeHandler = getSchemeHandler(options.scheme || component.scheme);
-      if (schemeHandler && schemeHandler.serialize)
-        schemeHandler.serialize(component, options);
+      if (schemeHandler && schemeHandler.serialize) schemeHandler.serialize(component, options);
       if (component.path !== void 0) {
         if (!options.skipEscape) {
           component.path = escape(component.path);
@@ -21103,10 +21091,10 @@ function queryEntities(graph, domainName) {
   for (const op of filtered) {
     const key = `${op.domain}:${op.entity}`;
     const existing = entityMap.get(key);
-    if (existing !== void 0) {
-      entityMap.set(key, { ...existing, operations: [...existing.operations, op] });
-    } else {
+    if (existing === void 0) {
       entityMap.set(key, { name: op.entity, domain: op.domain, operations: [op] });
+    } else {
+      entityMap.set(key, { ...existing, operations: [...existing.operations, op] });
     }
   }
   return Array.from(entityMap.values()).sort((a, b) => a.name.localeCompare(b.name)).map((partial2) => createEntity(graph, partial2));
@@ -21296,7 +21284,7 @@ function queryFlows(graph) {
         return;
       const edges = outgoingEdges.get(nodeId);
       const firstEdge = edges !== void 0 && edges.length > 0 ? edges[0] : void 0;
-      const linkType = firstEdge !== void 0 ? firstEdge.type : void 0;
+      const linkType = firstEdge === void 0 ? void 0 : firstEdge.type;
       const externalLinks = externalLinksBySource.get(nodeId) ?? [];
       steps.push({ component, linkType, depth, externalLinks });
       if (edges) {
@@ -22880,6 +22868,9 @@ var RiviereBuilder = class _RiviereBuilder {
     if (enrichment.behavior !== void 0) {
       component.behavior = mergeBehavior(component.behavior, enrichment.behavior);
     }
+    if (enrichment.signature !== void 0) {
+      component.signature = enrichment.signature;
+    }
   }
   componentNotFoundError(id) {
     return createSourceNotFoundError(this.graph.components, ComponentId.parse(id));
@@ -24076,6 +24067,65 @@ function buildBehavior(options) {
     }
   };
 }
+function parseParameter(input) {
+  const parts = input.split(":");
+  if (parts.length < 2 || parts.length > 3) {
+    return void 0;
+  }
+  const [name, type, description] = parts;
+  if (name === void 0 || name === "" || type === void 0 || type === "") {
+    return void 0;
+  }
+  return {
+    name: name.trim(),
+    type: type.trim(),
+    ...description !== void 0 && description !== "" && { description: description.trim() }
+  };
+}
+function parseParameters(paramsPart) {
+  if (paramsPart === "") {
+    return { success: true, parameters: [] };
+  }
+  const paramStrings = paramsPart.split(",").map((p) => p.trim());
+  const parameters = [];
+  for (const paramStr of paramStrings) {
+    const param = parseParameter(paramStr);
+    if (param === void 0) {
+      return { success: false, error: `Invalid parameter format: '${paramStr}'. Expected 'name:type' or 'name:type:description'.` };
+    }
+    parameters.push(param);
+  }
+  return { success: true, parameters };
+}
+function buildSignatureObject(parameters, returnType) {
+  const signature = {};
+  if (parameters.length > 0) {
+    signature.parameters = parameters;
+  }
+  if (returnType !== void 0 && returnType !== "") {
+    signature.returnType = returnType;
+  }
+  return signature;
+}
+function parseSignature(input) {
+  const trimmed = input.trim();
+  if (trimmed.startsWith("->")) {
+    const returnType2 = trimmed.slice(2).trim();
+    return returnType2 === "" ? { success: false, error: `Invalid signature format: '${input}'. Return type cannot be empty.` } : { success: true, signature: { returnType: returnType2 } };
+  }
+  const arrowIndex = trimmed.indexOf(" -> ");
+  const paramsPart = arrowIndex === -1 ? trimmed : trimmed.slice(0, arrowIndex).trim();
+  const returnType = arrowIndex === -1 ? void 0 : trimmed.slice(arrowIndex + 4).trim();
+  const paramsResult = parseParameters(paramsPart);
+  if (!paramsResult.success) {
+    return paramsResult;
+  }
+  const signature = buildSignatureObject(paramsResult.parameters, returnType);
+  if (paramsResult.parameters.length === 0 && returnType === void 0) {
+    return { success: false, error: `Invalid signature format: '${input}'. Expected 'param:type, ... -> ReturnType' or '-> ReturnType' or 'param:type'.` };
+  }
+  return { success: true, signature };
+}
 function handleEnrichmentError(error46) {
   if (error46 instanceof InvalidEnrichmentTargetError) {
     console.log(JSON.stringify(formatError2("INVALID_COMPONENT_TYPE" /* InvalidComponentType */, error46.message, [])));
@@ -24107,20 +24157,27 @@ Examples:
       --validates "amount > 0" \\
       --modifies "this.status <- Processing"
 `
-  ).requiredOption("--id <component-id>", "Component ID to enrich").option("--entity <name>", "Entity name").option("--state-change <from:to>", "State transition (repeatable)", collectOption, []).option("--business-rule <rule>", "Business rule (repeatable)", collectOption, []).option("--reads <value>", "What the operation reads (repeatable)", collectOption, []).option("--validates <value>", "What the operation validates (repeatable)", collectOption, []).option("--modifies <value>", "What the operation modifies (repeatable)", collectOption, []).option("--emits <value>", "What the operation emits (repeatable)", collectOption, []).option("--graph <path>", getDefaultGraphPathDescription()).option("--json", "Output result as JSON").action(async (options) => {
+  ).requiredOption("--id <component-id>", "Component ID to enrich").option("--entity <name>", "Entity name").option("--state-change <from:to>", "State transition (repeatable)", collectOption, []).option("--business-rule <rule>", "Business rule (repeatable)", collectOption, []).option("--reads <value>", "What the operation reads (repeatable)", collectOption, []).option("--validates <value>", "What the operation validates (repeatable)", collectOption, []).option("--modifies <value>", "What the operation modifies (repeatable)", collectOption, []).option("--emits <value>", "What the operation emits (repeatable)", collectOption, []).option("--signature <dsl>", 'Operation signature (e.g., "orderId:string, amount:number -> Order")').option("--graph <path>", getDefaultGraphPathDescription()).option("--json", "Output result as JSON").action(async (options) => {
     const parseResult = parseStateChanges(options.stateChange);
     if (!parseResult.success) {
       const msg = `Invalid state-change format: '${parseResult.invalidInput}'. Expected 'from:to'.`;
       console.log(JSON.stringify(formatError2("VALIDATION_ERROR" /* ValidationError */, msg, [])));
       return;
     }
+    const signatureResult = options.signature === void 0 ? void 0 : parseSignature(options.signature);
+    if (signatureResult !== void 0 && !signatureResult.success) {
+      console.log(JSON.stringify(formatError2("VALIDATION_ERROR" /* ValidationError */, signatureResult.error, [])));
+      return;
+    }
+    const parsedSignature = signatureResult?.success === true ? signatureResult.signature : void 0;
     await withGraphBuilder(options.graph, async (builder, graphPath) => {
       try {
         builder.enrichComponent(options.id, {
           ...options.entity !== void 0 && { entity: options.entity },
           ...parseResult.stateChanges.length > 0 && { stateChanges: parseResult.stateChanges },
           ...options.businessRule.length > 0 && { businessRules: options.businessRule },
-          ...buildBehavior(options)
+          ...buildBehavior(options),
+          ...parsedSignature !== void 0 && { signature: parsedSignature }
         });
       } catch (error46) {
         handleEnrichmentError(error46);
@@ -24178,7 +24235,7 @@ Examples:
     }
     await withGraphBuilder(options.graph, async (builder) => {
       const allComponents = builder.query().components();
-      const filteredComponents = options.type !== void 0 ? allComponents.filter((c) => c.type === options.type) : allComponents;
+      const filteredComponents = options.type === void 0 ? allComponents : allComponents.filter((c) => c.type === options.type);
       const checklistItems = filteredComponents.map((c) => ({
         id: c.id,
         type: c.type,
@@ -24486,9 +24543,9 @@ Examples:
     }
     await withGraph(options.graph, (query) => {
       const allComponents = query.components();
-      const filteredByDomain = options.domain !== void 0 ? allComponents.filter((c) => c.domain === options.domain) : allComponents;
-      const typeFilter = options.type !== void 0 ? normalizeToSchemaComponentType(options.type) : void 0;
-      const filteredByType = typeFilter !== void 0 ? filteredByDomain.filter((c) => c.type === typeFilter) : filteredByDomain;
+      const filteredByDomain = options.domain === void 0 ? allComponents : allComponents.filter((c) => c.domain === options.domain);
+      const typeFilter = options.type === void 0 ? void 0 : normalizeToSchemaComponentType(options.type);
+      const filteredByType = typeFilter === void 0 ? filteredByDomain : filteredByDomain.filter((c) => c.type === typeFilter);
       const components = filteredByType.map(toComponentOutput);
       if (options.json) {
         console.log(JSON.stringify(formatSuccess({ components })));

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@living-architecture/riviere-cli",
-  "version": "0.4.3",
+  "version": "0.4.5",
   "publishConfig": {
     "access": "public"
   },
@@ -26,8 +26,8 @@
   },
   "dependencies": {
     "commander": "^14.0.2",
-    "@living-architecture/riviere-builder": "0.3.3",
-    "@living-architecture/riviere-schema": "0.3.3",
-    "@living-architecture/riviere-query": "0.3.3"
+    "@living-architecture/riviere-schema": "0.3.5",
+    "@living-architecture/riviere-query": "0.3.5",
+    "@living-architecture/riviere-builder": "0.3.5"
   }
 }