docs(sysprom): record decisions and changes for issues #22, #23, #25

DEC48 + CHG46: Add external reference management commands (issue #22)

DEC49 + CHG47: Expand endpoint type support — add milestone to
depends_on sources, add role to constrained_by and governed_by sources
(issues #23 and #25)

Author: Mearman

.SysProM.json

@@ -3990,6 +3990,58 @@
 				"src/operations/validate.ts,tests/validate.unit.test.ts"
 			],
 			"type": "change"
+		},
+		{
+			"context": "Issue #22 reported that users must edit JSON directly to manage external references. These references are critical for linking nodes to source documents, ADRs, standards, and code files.",
+			"id": "DEC48",
+			"name": "CLI: manage external references",
+			"options": [
+				{
+					"description": "Add update add-ref and update remove-ref subcommands",
+					"id": "OPT-A"
+				},
+				{
+					"description": "Create a new manage-refs command",
+					"id": "OPT-B"
+				}
+			],
+			"rationale": "Adding subcommands follows the existing update command pattern, is simpler, and maintains consistency with other mutation operations.",
+			"selected": "OPT-A",
+			"type": "decision"
+		},
+		{
+			"id": "CHG46",
+			"name": "Add external reference management commands",
+			"scope": [
+				"src/operations/add-external-reference.ts,src/operations/remove-external-reference.ts,src/cli/commands/update.ts"
+			],
+			"type": "change"
+		},
+		{
+			"context": "Issues #23 and #25 reported missing node type support in relationship definitions. Milestones couldn't use depends_on, and roles couldn't use constrained_by or governed_by.",
+			"id": "DEC49",
+			"name": "Expand relationship endpoint type support",
+			"options": [
+				{
+					"description": "Add milestone to depends_on sources, and role to constrained_by and governed_by sources",
+					"id": "OPT-A"
+				},
+				{
+					"description": "Create a mapping configuration for endpoint types",
+					"id": "OPT-B"
+				}
+			],
+			"rationale": "Direct schema updates are simple, maintainable, and follow the existing pattern of endpoint type validation.",
+			"selected": "OPT-A",
+			"type": "decision"
+		},
+		{
+			"id": "CHG47",
+			"name": "Extend endpoint type support for relationships",
+			"scope": [
+				"src/endpoint-types.ts"
+			],
+			"type": "change"
 		}
 	],
 	"relationships": [
@@ -5142,6 +5194,16 @@
 			"from": "CHG45",
 			"to": "DEC47",
 			"type": "implements"
+		},
+		{
+			"from": "CHG46",
+			"to": "DEC48",
+			"type": "implements"
+		},
+		{
+			"from": "CHG47",
+			"to": "DEC49",
+			"type": "implements"
 		}
 	]
 }

.SysProM/CHANGES.md

@@ -798,3 +798,17 @@ Scope:
 Scope:
 - src/operations/validate.ts,tests/validate.unit.test.ts
 
+### CHG46 — Add external reference management commands
+
+- Implements: [DEC48](./DECISIONS.md#dec48--cli-manage-external-references)
+
+Scope:
+- src/operations/add-external-reference.ts,src/operations/remove-external-reference.ts,src/cli/commands/update.ts
+
+### CHG47 — Extend endpoint type support for relationships
+
+- Implements: [DEC49](./DECISIONS.md#dec49--expand-relationship-endpoint-type-support)
+
+Scope:
+- src/endpoint-types.ts
+

.SysProM/DECISIONS.md

@@ -958,3 +958,27 @@ Chosen: OPT-A
 
 Rationale: Lifecycle-aware validation is simpler, requires no schema changes, and aligns with the semantic meaning of undecided lifecycle states.
 
+### DEC48 — CLI: manage external references
+
+Context: Issue #22 reported that users must edit JSON directly to manage external references. These references are critical for linking nodes to source documents, ADRs, standards, and code files.
+
+Options:
+- OPT-A: Add update add-ref and update remove-ref subcommands
+- OPT-B: Create a new manage-refs command
+
+Chosen: OPT-A
+
+Rationale: Adding subcommands follows the existing update command pattern, is simpler, and maintains consistency with other mutation operations.
+
+### DEC49 — Expand relationship endpoint type support
+
+Context: Issues #23 and #25 reported missing node type support in relationship definitions. Milestones couldn't use depends_on, and roles couldn't use constrained_by or governed_by.
+
+Options:
+- OPT-A: Add milestone to depends_on sources, and role to constrained_by and governed_by sources
+- OPT-B: Create a mapping configuration for endpoint types
+
+Chosen: OPT-A
+
+Rationale: Direct schema updates are simple, maintainable, and follow the existing pattern of endpoint type validation.
+