sysprom 1.25.1 → 1.27.0

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

@@ -2,7 +2,7 @@ import pc from "picocolors";
 import * as z from "zod";
 import { textToString } from "../../text.js";
 import { readOpts, loadDoc } from "../shared.js";
-import { queryNodesOp, queryNodeOp, queryRelationshipsOp, traceFromNodeOp, timelineOp, nodeHistoryOp, stateAtOp, } from "../../operations/index.js";
+import { queryNodesOp, queryNodeOp, queryRelationshipsOp, queryRelationshipTypesOp, traceFromNodeOp, timelineOp, nodeHistoryOp, stateAtOp, } from "../../operations/index.js";
 import { NodeType, NodeStatus } from "../../schema.js";
 import { primaryLifecycleState } from "../../lifecycle-state.js";
 // ---------------------------------------------------------------------------
@@ -211,6 +211,26 @@ const timelineSubcommand = {
         }
     },
 };
+const relationshipTypesSubcommand = {
+    name: "relationship-types",
+    description: queryRelationshipTypesOp.def.description,
+    apiLink: queryRelationshipTypesOp.def.name,
+    opts: readOpts,
+    action(_rawArgs, rawOpts) {
+        const opts = readOpts.parse(rawOpts);
+        const relTypes = queryRelationshipTypesOp({});
+        if (opts.json) {
+            console.log(JSON.stringify(relTypes, null, 2));
+        }
+        else {
+            for (const relType of relTypes) {
+                console.log(pc.bold(relType.type));
+                console.log(`  ${pc.dim("from")}: ${relType.from.map((t) => pc.cyan(t)).join(", ")}`);
+                console.log(`  ${pc.dim("to")}: ${relType.to.map((t) => pc.cyan(t)).join(", ")}`);
+            }
+        }
+    },
+};
 const stateAtSubcommand = {
     name: "state-at",
     description: stateAtOp.def.description,
@@ -247,6 +267,7 @@ export const queryCommand = {
         nodesSubcommand,
         nodeSubcommand,
         relsSubcommand,
+        relationshipTypesSubcommand,
         traceSubcommand,
         timelineSubcommand,
         stateAtSubcommand,

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

@@ -1,6 +1,6 @@
 import * as z from "zod";
-import { RelationshipType, NodeStatus } from "../../schema.js";
-import { updateNodeOp, addRelationshipOp, removeRelationshipOp, updateMetadataOp, } from "../../operations/index.js";
+import { RelationshipType, NodeStatus, ExternalReferenceRole, } from "../../schema.js";
+import { updateNodeOp, addRelationshipOp, removeRelationshipOp, updateMetadataOp, addExternalReferenceOp, removeExternalReferenceOp, } from "../../operations/index.js";
 import { mutationOpts, loadDoc, persistDoc } from "../shared.js";
 // ---------------------------------------------------------------------------
 // CLI helper functions
@@ -80,6 +80,25 @@ const metaOpts = mutationOpts.extend({
         .array(z.string())
         .describe("metadata field updates (key=value format)"),
 });
+const addRefArgs = z.object({
+    id: z.string().describe("node ID to add reference to"),
+});
+const addRefOpts = mutationOpts.extend({
+    role: ExternalReferenceRole.describe("reference role"),
+    identifier: z
+        .string()
+        .describe("reference identifier (URI, file path, etc.)"),
+    description: z
+        .string()
+        .optional()
+        .describe("optional description of the reference"),
+});
+const removeRefArgs = z.object({
+    id: z.string().describe("node ID to remove reference from"),
+});
+const removeRefOpts = mutationOpts.extend({
+    identifier: z.string().describe("identifier of the reference to remove"),
+});
 // ---------------------------------------------------------------------------
 // Subcommands
 // ---------------------------------------------------------------------------
@@ -218,6 +237,65 @@ const metaSubcommand = {
         }
     },
 };
+const addRefSubcommand = {
+    name: "add-ref",
+    description: addExternalReferenceOp.def.description,
+    apiLink: addExternalReferenceOp.def.name,
+    args: addRefArgs,
+    opts: addRefOpts,
+    action(rawArgs, rawOpts) {
+        const args = addRefArgs.parse(rawArgs);
+        const opts = addRefOpts.parse(rawOpts);
+        const loaded = loadDoc(opts.path);
+        const { doc } = loaded;
+        const newDoc = addExternalReferenceOp({
+            doc,
+            nodeId: args.id,
+            role: opts.role,
+            identifier: opts.identifier,
+            description: opts.description,
+        });
+        persistDoc(newDoc, loaded, opts);
+        if (opts.json) {
+            const node = newDoc.nodes.find((n) => n.id === args.id);
+            const ref = node?.external_references?.find((r) => r.identifier === opts.identifier);
+            console.log(JSON.stringify(ref, null, 2));
+        }
+        else {
+            console.log(`${opts.dryRun ? "[dry-run] Would add" : "Added"} external reference to ${args.id}: ${opts.role} → ${opts.identifier}`);
+        }
+    },
+};
+const removeRefSubcommand = {
+    name: "remove-ref",
+    description: removeExternalReferenceOp.def.description,
+    apiLink: removeExternalReferenceOp.def.name,
+    args: removeRefArgs,
+    opts: removeRefOpts,
+    action(rawArgs, rawOpts) {
+        const args = removeRefArgs.parse(rawArgs);
+        const opts = removeRefOpts.parse(rawOpts);
+        const loaded = loadDoc(opts.path);
+        const { doc } = loaded;
+        removeExternalReferenceOp({
+            doc,
+            nodeId: args.id,
+            identifier: opts.identifier,
+        });
+        const newDoc = removeExternalReferenceOp({
+            doc,
+            nodeId: args.id,
+            identifier: opts.identifier,
+        });
+        persistDoc(newDoc, loaded, opts);
+        if (opts.json) {
+            console.log(JSON.stringify({ nodeId: args.id, identifier: opts.identifier }, null, 2));
+        }
+        else {
+            console.log(`${opts.dryRun ? "[dry-run] Would remove" : "Removed"} external reference from ${args.id}: ${opts.identifier}`);
+        }
+    },
+};
 // ---------------------------------------------------------------------------
 // Main command
 // ---------------------------------------------------------------------------
@@ -228,6 +306,8 @@ export const updateCommand = {
         nodeSubcommand,
         addRelSubcommand,
         removeRelSubcommand,
+        addRefSubcommand,
+        removeRefSubcommand,
         metaSubcommand,
     ],
 };

package/dist/src/endpoint-types.js

@@ -53,6 +53,7 @@ export const RELATIONSHIP_ENDPOINT_TYPES = {
             "role",
             "gate",
             "mode",
+            "milestone",
             "artefact",
             "decision",
             "change",
@@ -88,6 +89,7 @@ export const RELATIONSHIP_ENDPOINT_TYPES = {
             "decision",
             "change",
             "invariant",
+            "role",
         ],
         to: ["invariant", "principle", "policy", "protocol", "concept"],
     },
@@ -191,6 +193,7 @@ export const RELATIONSHIP_ENDPOINT_TYPES = {
             "change",
             "policy",
             "artefact",
+            "role",
         ],
         to: ["policy", "protocol", "role", "principle", "invariant", "concept"],
     },