@living-architecture/riviere-cli 0.2.5 → 0.3.1

package/dist/bin.js

@@ -6802,7 +6802,7 @@ var require_dist = __commonJS({
 });
 
 // src/cli.ts
-import { Command as Command20 } from "commander";
+import { Command as Command21 } from "commander";
 import { createRequire } from "module";
 
 // src/commands/builder/add-component.ts
@@ -24117,8 +24117,89 @@ Examples:
   });
 }
 
-// src/commands/query/entry-points.ts
+// src/commands/builder/define-custom-type.ts
 import { Command as Command14 } from "commander";
+import { writeFile as writeFile10 } from "node:fs/promises";
+var VALID_PROPERTY_TYPES = ["string", "number", "boolean", "array", "object"];
+function isValidPropertyType(value) {
+  return VALID_PROPERTY_TYPES.some((t) => t === value);
+}
+function parsePropertySpec(spec) {
+  const parts = spec.split(":");
+  if (parts.length < 2 || parts.length > 3) {
+    return { error: `Invalid property format: "${spec}". Expected "name:type" or "name:type:description"` };
+  }
+  const [name, type, description] = parts;
+  if (!name || name.trim() === "") {
+    return { error: "Property name cannot be empty" };
+  }
+  if (!type || !isValidPropertyType(type)) {
+    return { error: `Invalid property type: "${type}". Valid types: ${VALID_PROPERTY_TYPES.join(", ")}` };
+  }
+  const definition = { type };
+  if (description && description.trim() !== "") {
+    definition.description = description;
+  }
+  return { name: name.trim(), definition };
+}
+function parsePropertySpecs(specs) {
+  if (specs === void 0 || specs.length === 0) {
+    return { success: true, properties: {} };
+  }
+  const properties = {};
+  for (const spec of specs) {
+    const result = parsePropertySpec(spec);
+    if ("error" in result) {
+      return { success: false, error: result.error };
+    }
+    if (properties[result.name] !== void 0) {
+      return { success: false, error: `Duplicate property name: "${result.name}"` };
+    }
+    properties[result.name] = result.definition;
+  }
+  return { success: true, properties };
+}
+function collect(value, previous) {
+  return previous.concat([value]);
+}
+function createDefineCustomTypeCommand() {
+  return new Command14("define-custom-type").description("Define a custom component type").requiredOption("--name <name>", "Custom type name").option("--description <desc>", "Custom type description").option("--required-property <spec>", "Required property (format: name:type[:description])", collect, []).option("--optional-property <spec>", "Optional property (format: name:type[:description])", collect, []).option("--graph <path>", getDefaultGraphPathDescription()).option("--json", "Output result as JSON").action(async (options) => {
+    const requiredResult = parsePropertySpecs(options.requiredProperty);
+    if (!requiredResult.success) {
+      console.log(JSON.stringify(formatError2("VALIDATION_ERROR" /* ValidationError */, requiredResult.error, [])));
+      return;
+    }
+    const optionalResult = parsePropertySpecs(options.optionalProperty);
+    if (!optionalResult.success) {
+      console.log(JSON.stringify(formatError2("VALIDATION_ERROR" /* ValidationError */, optionalResult.error, [])));
+      return;
+    }
+    await withGraphBuilder(options.graph, async (builder, graphPath) => {
+      builder.defineCustomType({
+        name: options.name,
+        ...options.description !== void 0 && { description: options.description },
+        ...Object.keys(requiredResult.properties).length > 0 && { requiredProperties: requiredResult.properties },
+        ...Object.keys(optionalResult.properties).length > 0 && { optionalProperties: optionalResult.properties }
+      });
+      await writeFile10(graphPath, builder.serialize(), "utf-8");
+      if (options.json === true) {
+        console.log(
+          JSON.stringify(
+            formatSuccess({
+              name: options.name,
+              ...options.description !== void 0 && { description: options.description },
+              ...Object.keys(requiredResult.properties).length > 0 && { requiredProperties: requiredResult.properties },
+              ...Object.keys(optionalResult.properties).length > 0 && { optionalProperties: optionalResult.properties }
+            })
+          )
+        );
+      }
+    });
+  });
+}
+
+// src/commands/query/entry-points.ts
+import { Command as Command15 } from "commander";
 
 // src/commands/query/load-graph.ts
 import { readFile as readFile3 } from "node:fs/promises";
@@ -24166,7 +24247,7 @@ async function withGraph(graphPathOption, handler) {
 
 // src/commands/query/entry-points.ts
 function createEntryPointsCommand() {
-  return new Command14("entry-points").description("List entry points (APIs, UIs, EventHandlers with no incoming links)").addHelpText(
+  return new Command15("entry-points").description("List entry points (APIs, UIs, EventHandlers with no incoming links)").addHelpText(
     "after",
     `
 Examples:
@@ -24184,9 +24265,9 @@ Examples:
 }
 
 // src/commands/query/domains.ts
-import { Command as Command15 } from "commander";
+import { Command as Command16 } from "commander";
 function createDomainsCommand() {
-  return new Command15("domains").description("List domains with component counts").addHelpText(
+  return new Command16("domains").description("List domains with component counts").addHelpText(
     "after",
     `
 Examples:
@@ -24204,9 +24285,9 @@ Examples:
 }
 
 // src/commands/query/trace.ts
-import { Command as Command16 } from "commander";
+import { Command as Command17 } from "commander";
 function createTraceCommand() {
-  return new Command16("trace").description("Trace flow from a component (bidirectional)").addHelpText(
+  return new Command17("trace").description("Trace flow from a component (bidirectional)").addHelpText(
     "after",
     `
 Examples:
@@ -24240,9 +24321,9 @@ Examples:
 }
 
 // src/commands/query/orphans.ts
-import { Command as Command17 } from "commander";
+import { Command as Command18 } from "commander";
 function createOrphansCommand() {
-  return new Command17("orphans").description("Find orphan components with no links").addHelpText(
+  return new Command18("orphans").description("Find orphan components with no links").addHelpText(
     "after",
     `
 Examples:
@@ -24260,7 +24341,7 @@ Examples:
 }
 
 // src/commands/query/components.ts
-import { Command as Command18 } from "commander";
+import { Command as Command19 } from "commander";
 
 // src/commands/query/component-output.ts
 function toComponentOutput(component) {
@@ -24274,7 +24355,7 @@ function toComponentOutput(component) {
 
 // src/commands/query/components.ts
 function createComponentsCommand() {
-  return new Command18("components").description("List components with optional filtering").addHelpText(
+  return new Command19("components").description("List components with optional filtering").addHelpText(
     "after",
     `
 Examples:
@@ -24307,9 +24388,9 @@ Examples:
 }
 
 // src/commands/query/search.ts
-import { Command as Command19 } from "commander";
+import { Command as Command20 } from "commander";
 function createSearchCommand() {
-  return new Command19("search").description("Search components by name").addHelpText(
+  return new Command20("search").description("Search components by name").addHelpText(
     "after",
     `
 Examples:
@@ -24343,7 +24424,7 @@ function loadPackageJson() {
 }
 var packageJson = loadPackageJson();
 function createProgram() {
-  const program2 = new Command20();
+  const program2 = new Command21();
   program2.name("riviere").version(packageJson.version);
   const builderCmd = program2.command("builder").description("Commands for building a graph");
   builderCmd.addCommand(createAddComponentCommand());
@@ -24359,6 +24440,7 @@ function createProgram() {
   builderCmd.addCommand(createComponentSummaryCommand());
   builderCmd.addCommand(createComponentChecklistCommand());
   builderCmd.addCommand(createCheckConsistencyCommand());
+  builderCmd.addCommand(createDefineCustomTypeCommand());
   const queryCmd = program2.command("query").description("Commands for querying a graph");
   queryCmd.addCommand(createEntryPointsCommand());
   queryCmd.addCommand(createDomainsCommand());

package/dist/index.js

@@ -6801,7 +6801,7 @@ var require_dist = __commonJS({
 });
 
 // src/cli.ts
-import { Command as Command20 } from "commander";
+import { Command as Command21 } from "commander";
 import { createRequire } from "module";
 
 // src/commands/builder/add-component.ts
@@ -24133,8 +24133,89 @@ Examples:
   });
 }
 
-// src/commands/query/entry-points.ts
+// src/commands/builder/define-custom-type.ts
 import { Command as Command14 } from "commander";
+import { writeFile as writeFile10 } from "node:fs/promises";
+var VALID_PROPERTY_TYPES = ["string", "number", "boolean", "array", "object"];
+function isValidPropertyType(value) {
+  return VALID_PROPERTY_TYPES.some((t) => t === value);
+}
+function parsePropertySpec(spec) {
+  const parts = spec.split(":");
+  if (parts.length < 2 || parts.length > 3) {
+    return { error: `Invalid property format: "${spec}". Expected "name:type" or "name:type:description"` };
+  }
+  const [name, type, description] = parts;
+  if (!name || name.trim() === "") {
+    return { error: "Property name cannot be empty" };
+  }
+  if (!type || !isValidPropertyType(type)) {
+    return { error: `Invalid property type: "${type}". Valid types: ${VALID_PROPERTY_TYPES.join(", ")}` };
+  }
+  const definition = { type };
+  if (description && description.trim() !== "") {
+    definition.description = description;
+  }
+  return { name: name.trim(), definition };
+}
+function parsePropertySpecs(specs) {
+  if (specs === void 0 || specs.length === 0) {
+    return { success: true, properties: {} };
+  }
+  const properties = {};
+  for (const spec of specs) {
+    const result = parsePropertySpec(spec);
+    if ("error" in result) {
+      return { success: false, error: result.error };
+    }
+    if (properties[result.name] !== void 0) {
+      return { success: false, error: `Duplicate property name: "${result.name}"` };
+    }
+    properties[result.name] = result.definition;
+  }
+  return { success: true, properties };
+}
+function collect(value, previous) {
+  return previous.concat([value]);
+}
+function createDefineCustomTypeCommand() {
+  return new Command14("define-custom-type").description("Define a custom component type").requiredOption("--name <name>", "Custom type name").option("--description <desc>", "Custom type description").option("--required-property <spec>", "Required property (format: name:type[:description])", collect, []).option("--optional-property <spec>", "Optional property (format: name:type[:description])", collect, []).option("--graph <path>", getDefaultGraphPathDescription()).option("--json", "Output result as JSON").action(async (options) => {
+    const requiredResult = parsePropertySpecs(options.requiredProperty);
+    if (!requiredResult.success) {
+      console.log(JSON.stringify(formatError2("VALIDATION_ERROR" /* ValidationError */, requiredResult.error, [])));
+      return;
+    }
+    const optionalResult = parsePropertySpecs(options.optionalProperty);
+    if (!optionalResult.success) {
+      console.log(JSON.stringify(formatError2("VALIDATION_ERROR" /* ValidationError */, optionalResult.error, [])));
+      return;
+    }
+    await withGraphBuilder(options.graph, async (builder, graphPath) => {
+      builder.defineCustomType({
+        name: options.name,
+        ...options.description !== void 0 && { description: options.description },
+        ...Object.keys(requiredResult.properties).length > 0 && { requiredProperties: requiredResult.properties },
+        ...Object.keys(optionalResult.properties).length > 0 && { optionalProperties: optionalResult.properties }
+      });
+      await writeFile10(graphPath, builder.serialize(), "utf-8");
+      if (options.json === true) {
+        console.log(
+          JSON.stringify(
+            formatSuccess({
+              name: options.name,
+              ...options.description !== void 0 && { description: options.description },
+              ...Object.keys(requiredResult.properties).length > 0 && { requiredProperties: requiredResult.properties },
+              ...Object.keys(optionalResult.properties).length > 0 && { optionalProperties: optionalResult.properties }
+            })
+          )
+        );
+      }
+    });
+  });
+}
+
+// src/commands/query/entry-points.ts
+import { Command as Command15 } from "commander";
 
 // src/commands/query/load-graph.ts
 import { readFile as readFile3 } from "node:fs/promises";
@@ -24182,7 +24263,7 @@ async function withGraph(graphPathOption, handler) {
 
 // src/commands/query/entry-points.ts
 function createEntryPointsCommand() {
-  return new Command14("entry-points").description("List entry points (APIs, UIs, EventHandlers with no incoming links)").addHelpText(
+  return new Command15("entry-points").description("List entry points (APIs, UIs, EventHandlers with no incoming links)").addHelpText(
     "after",
     `
 Examples:
@@ -24200,9 +24281,9 @@ Examples:
 }
 
 // src/commands/query/domains.ts
-import { Command as Command15 } from "commander";
+import { Command as Command16 } from "commander";
 function createDomainsCommand() {
-  return new Command15("domains").description("List domains with component counts").addHelpText(
+  return new Command16("domains").description("List domains with component counts").addHelpText(
     "after",
     `
 Examples:
@@ -24220,9 +24301,9 @@ Examples:
 }
 
 // src/commands/query/trace.ts
-import { Command as Command16 } from "commander";
+import { Command as Command17 } from "commander";
 function createTraceCommand() {
-  return new Command16("trace").description("Trace flow from a component (bidirectional)").addHelpText(
+  return new Command17("trace").description("Trace flow from a component (bidirectional)").addHelpText(
     "after",
     `
 Examples:
@@ -24256,9 +24337,9 @@ Examples:
 }
 
 // src/commands/query/orphans.ts
-import { Command as Command17 } from "commander";
+import { Command as Command18 } from "commander";
 function createOrphansCommand() {
-  return new Command17("orphans").description("Find orphan components with no links").addHelpText(
+  return new Command18("orphans").description("Find orphan components with no links").addHelpText(
     "after",
     `
 Examples:
@@ -24276,7 +24357,7 @@ Examples:
 }
 
 // src/commands/query/components.ts
-import { Command as Command18 } from "commander";
+import { Command as Command19 } from "commander";
 
 // src/commands/query/component-output.ts
 function toComponentOutput(component) {
@@ -24290,7 +24371,7 @@ function toComponentOutput(component) {
 
 // src/commands/query/components.ts
 function createComponentsCommand() {
-  return new Command18("components").description("List components with optional filtering").addHelpText(
+  return new Command19("components").description("List components with optional filtering").addHelpText(
     "after",
     `
 Examples:
@@ -24323,9 +24404,9 @@ Examples:
 }
 
 // src/commands/query/search.ts
-import { Command as Command19 } from "commander";
+import { Command as Command20 } from "commander";
 function createSearchCommand() {
-  return new Command19("search").description("Search components by name").addHelpText(
+  return new Command20("search").description("Search components by name").addHelpText(
     "after",
     `
 Examples:
@@ -24359,7 +24440,7 @@ function loadPackageJson() {
 }
 var packageJson = loadPackageJson();
 function createProgram() {
-  const program = new Command20();
+  const program = new Command21();
   program.name("riviere").version(packageJson.version);
   const builderCmd = program.command("builder").description("Commands for building a graph");
   builderCmd.addCommand(createAddComponentCommand());
@@ -24375,6 +24456,7 @@ function createProgram() {
   builderCmd.addCommand(createComponentSummaryCommand());
   builderCmd.addCommand(createComponentChecklistCommand());
   builderCmd.addCommand(createCheckConsistencyCommand());
+  builderCmd.addCommand(createDefineCustomTypeCommand());
   const queryCmd = program.command("query").description("Commands for querying a graph");
   queryCmd.addCommand(createEntryPointsCommand());
   queryCmd.addCommand(createDomainsCommand());

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@living-architecture/riviere-cli",
-  "version": "0.2.5",
+  "version": "0.3.1",
   "publishConfig": {
     "access": "public"
   },
@@ -27,8 +27,8 @@
   "dependencies": {
     "commander": "^14.0.2",
     "tslib": "^2.3.0",
-    "@living-architecture/riviere-query": "0.2.4",
-    "@living-architecture/riviere-schema": "0.2.2",
-    "@living-architecture/riviere-builder": "0.2.4"
+    "@living-architecture/riviere-query": "0.2.5",
+    "@living-architecture/riviere-schema": "0.2.3",
+    "@living-architecture/riviere-builder": "0.2.5"
   }
 }