sysprom 1.26.0 → 1.27.1

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

@@ -16,6 +16,7 @@ export const RELATIONSHIP_ENDPOINT_TYPES = {
             "realisation",
             "principle",
             "policy",
+            "milestone",
         ],
         to: [
             "intent",
@@ -29,13 +30,34 @@ export const RELATIONSHIP_ENDPOINT_TYPES = {
     },
     // Realises — implementation hierarchy
     realises: {
-        from: ["capability", "element", "realisation", "artefact", "mode"],
-        to: ["capability", "element", "realisation", "concept", "stage"],
+        from: [
+            "capability",
+            "element",
+            "realisation",
+            "artefact",
+            "mode",
+            "milestone",
+        ],
+        to: [
+            "capability",
+            "element",
+            "realisation",
+            "concept",
+            "stage",
+            "milestone",
+        ],
     },
     // Implements — operationalisation
     implements: {
-        from: ["element", "realisation", "change", "stage"],
-        to: ["capability", "element", "realisation", "decision", "change"],
+        from: ["element", "realisation", "change", "stage", "milestone"],
+        to: [
+            "capability",
+            "element",
+            "realisation",
+            "decision",
+            "change",
+            "milestone",
+        ],
     },
     // Depends on — broad dependency across all node types
     depends_on: {
@@ -53,6 +75,7 @@ export const RELATIONSHIP_ENDPOINT_TYPES = {
             "role",
             "gate",
             "mode",
+            "milestone",
             "artefact",
             "decision",
             "change",
@@ -88,12 +111,14 @@ export const RELATIONSHIP_ENDPOINT_TYPES = {
             "decision",
             "change",
             "invariant",
+            "role",
+            "milestone",
         ],
         to: ["invariant", "principle", "policy", "protocol", "concept"],
     },
     // Affects — broad impact relationships
     affects: {
-        from: ["decision", "change", "artefact", "stage"],
+        from: ["decision", "change", "artefact", "stage", "milestone"],
         to: [
             "intent",
             "concept",
@@ -161,6 +186,7 @@ export const RELATIONSHIP_ENDPOINT_TYPES = {
             "role",
             "gate",
             "mode",
+            "milestone",
         ],
         to: [
             "intent",
@@ -176,6 +202,7 @@ export const RELATIONSHIP_ENDPOINT_TYPES = {
             "role",
             "gate",
             "mode",
+            "milestone",
         ],
     },
     // Governed by — governance relationships
@@ -191,12 +218,14 @@ export const RELATIONSHIP_ENDPOINT_TYPES = {
             "change",
             "policy",
             "artefact",
+            "role",
+            "milestone",
         ],
         to: ["policy", "protocol", "role", "principle", "invariant", "concept"],
     },
     // Modifies — mutation and change
     modifies: {
-        from: ["change", "stage"],
+        from: ["change", "stage", "milestone"],
         to: [
             "intent",
             "concept",
@@ -208,7 +237,7 @@ export const RELATIONSHIP_ENDPOINT_TYPES = {
     },
     // Produces — generation
     produces: {
-        from: ["stage", "realisation", "concept", "capability"],
+        from: ["stage", "realisation", "concept", "capability", "milestone"],
         to: ["artefact", "concept"],
     },
 };