yarramate 0.9.0 → 0.10.0

package/dist/projection.d.ts

@@ -9,6 +9,7 @@ export interface ProjectionDefinition {
         readonly documents?: readonly string[];
         readonly kinds?: readonly string[];
         readonly statuses?: readonly LifecycleStatus[];
+        readonly excludeStatuses?: readonly LifecycleStatus[];
         readonly states?: readonly string[];
         readonly owners?: readonly string[];
         readonly constraints?: readonly string[];

package/dist/projection.js

@@ -65,6 +65,9 @@ export function evaluateProjection(graph, projection, profileContext) {
             (projection.query.statuses === undefined ||
                 (status !== undefined &&
                     projection.query.statuses.includes(status))) &&
+            (projection.query.excludeStatuses === undefined ||
+                status === undefined ||
+                !projection.query.excludeStatuses.includes(status)) &&
             (projection.query.owners === undefined ||
                 (owner !== undefined &&
                     projection.query.owners.includes(owner))) &&
@@ -80,8 +83,12 @@ export function evaluateProjection(graph, projection, profileContext) {
             if (subject.type !== 'relationship')
                 continue;
             const relationship = graph.claims.find((claim) => claim.id === subject.id);
+            const relationshipStatus = claimValue(graph.claims, subject.id, 'yarramate/lifecycle/status');
             if (relationship === undefined ||
                 !('ref' in relationship.object) ||
+                (projection.query.excludeStatuses !== undefined &&
+                    relationshipStatus !== undefined &&
+                    projection.query.excludeStatuses.includes(relationshipStatus)) ||
                 (projection.query.relationshipKinds !== undefined &&
                     !projection.query.relationshipKinds.some((selectedKind) => selectedKind === relationship.predicate ||
                         (projection.query.kindMatching === 'descendants' &&
@@ -93,6 +100,20 @@ export function evaluateProjection(graph, projection, profileContext) {
             }
             const sourceSelected = initiallySelectedConceptIds.has(relationship.subject);
             const targetSelected = initiallySelectedConceptIds.has(relationship.object.ref);
+            // excludeStatuses also vetoes connected expansion: an excluded
+            // concept is never pulled in as a neighbour, and edges touching
+            // one are dropped rather than left dangling.
+            const endpointExcluded = (id) => {
+                if (projection.query.excludeStatuses === undefined)
+                    return false;
+                const endpointStatus = claimValue(graph.claims, id, 'yarramate/lifecycle/status');
+                return (endpointStatus !== undefined &&
+                    projection.query.excludeStatuses.includes(endpointStatus));
+            };
+            if (endpointExcluded(relationship.subject) ||
+                endpointExcluded(relationship.object.ref)) {
+                continue;
+            }
             if ((relationshipMode === 'between' &&
                 sourceSelected &&
                 targetSelected) ||

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "yarramate",
-  "version": "0.9.0",
+  "version": "0.10.0",
   "description": "Tool-neutral semantic architecture engine and guided methodology",
   "license": "MIT",
   "repository": {

package/schema/yarramate-projection.schema.json

@@ -49,6 +49,14 @@
             "enum": ["planned", "current", "retired"]
           }
         },
+        "excludeStatuses": {
+          "description": "Drop concepts carrying one of these lifecycle statuses while keeping concepts that declare no status at all - 'everything except retired' for viewpoint projections, where a bare statuses filter would wrongly drop unstatused actors and motivation elements.",
+          "type": "array",
+          "uniqueItems": true,
+          "items": {
+            "enum": ["planned", "current", "retired"]
+          }
+        },
         "states": {
           "type": "array",
           "minItems": 1,