sysprom 1.23.1 → 1.25.0

package/dist/src/cli/commands/update.js

@@ -51,10 +51,15 @@ const updateNodeArgs = z.object({
     id: z.string().describe("node ID to update"),
 });
 const updateNodeOpts = mutationOpts.extend({
+    name: z.string().optional().describe("update node name"),
     description: z.string().optional().describe("update node description"),
     status: NodeStatus.optional().describe("set lifecycle state to true"),
     context: z.string().optional().describe("update node context"),
     rationale: z.string().optional().describe("update node rationale"),
+    selected: z
+        .string()
+        .optional()
+        .describe("set selected option on decision nodes"),
     lifecycle: z
         .array(z.string())
         .optional()
@@ -95,12 +100,16 @@ const nodeSubcommand = {
             process.exit(1);
         }
         const fields = {};
+        if (opts.name !== undefined)
+            fields.name = opts.name;
         if (opts.description !== undefined)
             fields.description = opts.description;
         if (opts.context !== undefined)
             fields.context = opts.context;
         if (opts.rationale !== undefined)
             fields.rationale = opts.rationale;
+        if (opts.selected !== undefined)
+            fields.selected = opts.selected;
         const lifecycleArgs = [...(opts.lifecycle ?? [])];
         if (opts.status !== undefined) {
             lifecycleArgs.push(`${opts.status}=true`);
@@ -111,7 +120,7 @@ const nodeSubcommand = {
         }
         if (Object.keys(fields).length === 0) {
             console.error("No fields specified to update.");
-            console.error("Use --description, --status, --context, --rationale, or --lifecycle.");
+            console.error("Use --name, --description, --status, --context, --rationale, --selected, or --lifecycle.");
             process.exit(1);
         }
         const newDoc = updateNodeOp({ doc, id: args.id, fields });

package/dist/src/cli/define-command.js

@@ -160,11 +160,11 @@ function registerOption(cmd, flagName, field, desc) {
             opt.makeOptionMandatory(true);
         cmd.addOption(opt);
     }
-    else if (optional) {
-        cmd.addOption(new Option(`--${flagName} <value>`).hideHelp());
-    }
     else {
-        cmd.addOption(new Option(`--${flagName} <value>`).makeOptionMandatory(true).hideHelp());
+        const opt = new Option(`--${flagName} <value>`, desc);
+        if (!optional)
+            opt.makeOptionMandatory(true);
+        cmd.addOption(opt);
     }
 }
 function registerOptions(cmd, optsSchema) {

package/dist/src/cli/program.js

@@ -3,6 +3,7 @@ import { dirname, resolve } from "node:path";
 import { fileURLToPath } from "node:url";
 import { Command } from "commander";
 import { buildCommander } from "./define-command.js";
+import { formatCliError } from "./shared.js";
 let cachedVersion;
 function getVersion() {
     if (cachedVersion === undefined) {
@@ -81,3 +82,13 @@ program
     .action(async () => {
     await import("../mcp/server.js");
 });
+// Global error handlers for uncaught exceptions
+process.on("uncaughtException", (error) => {
+    console.error(formatCliError(error, false));
+    process.exit(1);
+});
+process.on("unhandledRejection", (reason) => {
+    const error = reason instanceof Error ? reason : new Error(String(reason));
+    console.error(formatCliError(error, false));
+    process.exit(1);
+});

package/dist/src/cli/shared.d.ts

@@ -72,3 +72,18 @@ export declare function loadDoc(input?: string): LoadedDoc;
  * ```
  */
 export declare function persistDoc(doc: SysProMDocument, loaded: LoadedDoc, opts: MutationOpts): void;
+/**
+ * Format an error message for CLI output with issue filing guidance.
+ * If the error appears to be unexpected (not a user error), suggests filing an issue.
+ * @param error - The error to format
+ * @param isUserError - Whether this is a user error (e.g. invalid input); if false, suggests filing an issue
+ * @returns Formatted error message
+ * @example
+ * ```ts
+ * try { ... } catch (err: unknown) {
+ *   console.error(formatCliError(err, false)); // Not a user error - suggest issue
+ *   process.exit(1);
+ * }
+ * ```
+ */
+export declare function formatCliError(error: unknown, isUserError?: boolean): string;

package/dist/src/cli/shared.js

@@ -207,3 +207,28 @@ export function persistDoc(doc, loaded, opts) {
         }
     }
 }
+// ---------------------------------------------------------------------------
+// Error formatting and reporting
+// ---------------------------------------------------------------------------
+const ISSUE_URL = "https://github.com/ExaDev/SysProM/issues/new";
+/**
+ * Format an error message for CLI output with issue filing guidance.
+ * If the error appears to be unexpected (not a user error), suggests filing an issue.
+ * @param error - The error to format
+ * @param isUserError - Whether this is a user error (e.g. invalid input); if false, suggests filing an issue
+ * @returns Formatted error message
+ * @example
+ * ```ts
+ * try { ... } catch (err: unknown) {
+ *   console.error(formatCliError(err, false)); // Not a user error - suggest issue
+ *   process.exit(1);
+ * }
+ * ```
+ */
+export function formatCliError(error, isUserError = false) {
+    const message = error instanceof Error ? error.message : String(error);
+    if (isUserError) {
+        return message;
+    }
+    return `${message}\n\nIf this was unexpected or bad UX, please file an issue:\n${ISSUE_URL}`;
+}

package/dist/src/mcp/server.js

@@ -7,19 +7,27 @@ import { NodeType, RelationshipType } from "../schema.js";
 import { validateOp, statsOp, queryNodesOp, queryNodeOp, queryRelationshipsOp, traceFromNodeOp, addNodeOp, removeNodeOp, updateNodeOp, addRelationshipOp, removeRelationshipOp, nextIdOp, inferCompletenessOp, inferLifecycleOp, inferImpactOp, impactSummaryOp, inferDerivedOp, } from "../operations/index.js";
 /**
  * Wrap an error with a descriptive prefix and attach the original as cause.
+ * Adds issue filing guidance for unexpected errors.
  * @param prefix - The error prefix (e.g., "Failed to add node")
  * @param error - The caught error
+ * @param isUserError - Whether this is a user error; if false, suggests filing an issue
  * @example
  * ```ts
  * try {
  *   someOperation();
  * } catch (error) {
- *   wrapError("Failed to do X", error);
+ *   wrapError("Failed to do X", error, false); // Not a user error - suggest issue
  * }
  * ```
  */
-function wrapError(prefix, error) {
-    throw new Error(`${prefix}: ${error instanceof Error ? error.message : String(error)}`, { cause: error });
+function wrapError(prefix, error, isUserError = false) {
+    const message = error instanceof Error ? error.message : String(error);
+    const fullMessage = `${prefix}: ${message}`;
+    const issueUrl = "https://github.com/ExaDev/SysProM/issues/new";
+    const errorMsg = isUserError
+        ? fullMessage
+        : `${fullMessage}\n\nIf this was unexpected or bad UX, please file an issue: ${issueUrl}`;
+    throw new Error(errorMsg, { cause: error });
 }
 // Create MCP server instance
 const server = new McpServer({

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "sysprom",
-	"version": "1.23.1",
+	"version": "1.25.0",
 	"description": "SysProM — System Provenance Model CLI and library",
 	"author": "ExaDev",
 	"homepage": "https://exadev.github.io/SysProM",