@cyberismo/assets 0.0.21 → 0.0.23

package/dist/schemas.d.ts

@@ -45,6 +45,11 @@ export declare const schemas: ({
             format: string;
             description: string;
         };
+        createdAt: {
+            type: string;
+            format: string;
+            description: string;
+        };
         labels: {
             type: string;
             description: string;
@@ -78,6 +83,40 @@ export declare const schemas: ({
                 additionalProperties: boolean;
             };
         };
+        externalLinks: {
+            type: string;
+            description: string;
+            items: {
+                type: string;
+                properties: {
+                    connector: {
+                        type: string;
+                        minLength: number;
+                        description: string;
+                    };
+                    externalItemKey: {
+                        type: string;
+                        minLength: number;
+                        description: string;
+                    };
+                    linkType: {
+                        description: string;
+                        type: string;
+                    };
+                    linkDescription: {
+                        type: string;
+                        description: string;
+                    };
+                    direction: {
+                        type: string;
+                        enum: string[];
+                        description: string;
+                    };
+                };
+                required: string[];
+                additionalProperties: boolean;
+            };
+        };
         templateCardKey: {
             type: string;
             description: string;

package/dist/static/pdf-themes/cyberismo-theme.yml

@@ -49,6 +49,15 @@ header:
     left:
       content: image:img/cyberismo-logo.png[pdfwidth=12%]
 
+ulist:
+  marker:
+    checked:
+      content: "\uf14a"
+      font-family: far
+    unchecked:
+      content: "\uf0c8"
+      font-family: far
+
 footer:
   columns: =100%
   recto: &shared_footer

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@cyberismo/assets",
-  "version": "0.0.21",
+  "version": "0.0.23",
   "description": "This package contains static resources",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",

package/src/calculations/common/base.lp

@@ -19,9 +19,15 @@ templateCard(C) :- card(C), field(C, "container", "template").
 dataType(Card, "lastUpdated", "dateTime") :-
     field(Card, "lastUpdated", _).
 
+dataType(Card, "createdAt", "dateTime") :-
+    field(Card, "createdAt", _).
+
 dataType(Connector, "lastSynchronised", "dateTime") :-
     field(Connector, "lastSynchronised", _).
 
+dataType(Card, "progress", "integer") :-
+    field(Card, "progress", _).
+
 % add workflow state category as a calculated field for Cards
 field(Card, "workflowStateCategory", Category) :-
     card(Card),

package/src/calculations/common/utils.lp

@@ -101,22 +101,73 @@ resultField((Source, Destination, LinkType, LinkDescription, Direction), "linkSo
     childResult(_, (Source, Destination, LinkType, LinkDescription, Direction), "links"),
     calculatedLink(Source, Destination, LinkType, LinkDescription).
 
-% links: title
+% links: title - for card destinations
 resultField((Card, Destination, LinkType, LinkDescription, Direction), "title", Title, "shortText") :-
     childResult(Card, (Card, Destination, LinkType, LinkDescription, Direction), "links"),
-    field(Destination, "title", Title).
+    field(Destination, "title", Title),
+    card(Destination).
 
+% links: title - for external item destinations (from externalItem facts)
+resultField((Card, (Connector, ItemKey), LinkType, LinkDescription, Direction), "title", Title, "shortText") :-
+    childResult(Card, (Card, (Connector, ItemKey), LinkType, LinkDescription, Direction), "links"),
+    field((Connector, ItemKey), "title", Title).
+
+% links: title - for external item destinations (fallback to key if no title fact)
+resultField((Card, (Connector, ItemKey), LinkType, LinkDescription, Direction), "title", ItemKey, "shortText") :-
+    childResult(Card, (Card, (Connector, ItemKey), LinkType, LinkDescription, Direction), "links"),
+    not field((Connector, ItemKey), "title", _).
+
+% links: title - for card sources (inbound)
 resultField((Source, Card, LinkType, LinkDescription, Direction), "title", Title, "shortText") :-
     childResult(Card, (Source, Card, LinkType, LinkDescription, Direction), "links"),
-    field(Source, "title", Title).
+    field(Source, "title", Title),
+    card(Source).
+
+% links: title - for external item sources (inbound, from externalItem facts)
+resultField(((Connector, ItemKey), Card, LinkType, LinkDescription, Direction), "title", Title, "shortText") :-
+    childResult(Card, ((Connector, ItemKey), Card, LinkType, LinkDescription, Direction), "links"),
+    field((Connector, ItemKey), "title", Title).
 
-% links: key
+% links: title - for external item sources (inbound, fallback to key if no title fact)
+resultField(((Connector, ItemKey), Card, LinkType, LinkDescription, Direction), "title", ItemKey, "shortText") :-
+    childResult(Card, ((Connector, ItemKey), Card, LinkType, LinkDescription, Direction), "links"),
+    not field((Connector, ItemKey), "title", _).
+
+% links: key - for card destinations
 resultField((Card, Destination, LinkType, LinkDescription, Direction), "key", Destination, "shortText") :-
-    childResult(Card, (Card, Destination, LinkType, LinkDescription, Direction), "links").
+    childResult(Card, (Card, Destination, LinkType, LinkDescription, Direction), "links"),
+    card(Destination).
+
+% links: key - for external item destinations
+resultField((Card, (Connector, ItemKey), LinkType, LinkDescription, Direction), "key", ItemKey, "shortText") :-
+    childResult(Card, (Card, (Connector, ItemKey), LinkType, LinkDescription, Direction), "links").
 
+% links: key - for card sources (inbound)
 resultField((Source, Card, LinkType, LinkDescription, Direction), "key", Source, "shortText") :-
     childResult(Card, (Source, Card, LinkType, LinkDescription, Direction), "links"),
-    field(Source, "title", Title).
+    card(Source).
+
+% links: key - for external item sources (inbound)
+resultField(((Connector, ItemKey), Card, LinkType, LinkDescription, Direction), "key", ItemKey, "shortText") :-
+    childResult(Card, ((Connector, ItemKey), Card, LinkType, LinkDescription, Direction), "links").
+
+% links: connector - for external item destinations
+resultField((Card, (Connector, ItemKey), LinkType, LinkDescription, Direction), "connector", Connector, "shortText") :-
+    childResult(Card, (Card, (Connector, ItemKey), LinkType, LinkDescription, Direction), "links").
+
+% links: connector - for external item sources (inbound)
+resultField(((Connector, ItemKey), Card, LinkType, LinkDescription, Direction), "connector", Connector, "shortText") :-
+    childResult(Card, ((Connector, ItemKey), Card, LinkType, LinkDescription, Direction), "links").
+
+% links: url - for external item destinations (only if url fact exists)
+resultField((Card, (Connector, ItemKey), LinkType, LinkDescription, Direction), "url", Url, "shortText") :-
+    childResult(Card, (Card, (Connector, ItemKey), LinkType, LinkDescription, Direction), "links"),
+    field((Connector, ItemKey), "url", Url).
+
+% links: url - for external item sources (inbound, only if url fact exists)
+resultField(((Connector, ItemKey), Card, LinkType, LinkDescription, Direction), "url", Url, "shortText") :-
+    childResult(Card, ((Connector, ItemKey), Card, LinkType, LinkDescription, Direction), "links"),
+    field((Connector, ItemKey), "url", Url).
 
 
 % notifications

package/src/calculations/queries/card.lp

@@ -96,6 +96,7 @@ select(1, "results", "cardTypeDisplayName").
 select(1, "results", "title").
 select(1, "results", "key").
 select(1, "results", "lastUpdated").
+select(1, "results", "createdAt").
 select(1, "results", "workflowState").
 select(1, "results", "policyChecks").
 select(1, "results", "links").

package/src/calculations/queries/connectors.lp

@@ -0,0 +1,11 @@
+% Connectors
+result(Name) :- connector(Name).
+resultField(Name, "type", "connector", "shortText") :- connector(Name).
+resultField(Name, "displayName", Value, "shortText") :- connector(Name), field(Name, "displayName", Value).
+
+% External items
+result((Connector, Key)) :- externalItem((Connector, Key)).
+resultField((Connector, Key), "type", "item", "shortText") :- externalItem((Connector, Key)).
+resultField((Connector, Key), "connector", Connector, "shortText") :- externalItem((Connector, Key)).
+resultField((Connector, Key), "itemKey", Key, "shortText") :- externalItem((Connector, Key)).
+resultField((Connector, Key), "title", Value, "shortText") :- externalItem((Connector, Key)), field((Connector, Key), "title", Value).

package/src/exportPdfReport/index.adoc.hbs

@@ -23,6 +23,9 @@ toc::[]
 | Card key | {{this.key}}
 | Card type | {{#if this.cardTypeDisplayName}}{{this.cardTypeDisplayName}}{{else}}{{this.cardType}}{{/if}}
 | Last modified | {{this.lastUpdated}}
+{{#if this.createdAt}}
+| Created at | {{this.createdAt}}
+{{/if}}
 {{#if this.labels}}
 | Labels | {{#each this.labels}}{{this}}{{#unless @last}}, {{/unless}}{{/each}}
 {{/if}}
@@ -38,7 +41,7 @@ toc::[]
 [cols="1,4",frame=none,grid=none]
 |===
 {{#each this.links}}
-| {{displayName}} | xref:{{this.key}}[{{this.title}}]{{#if this.linkDescription}} - {{this.linkDescription}}{{/if}}
+| {{displayName}} | {{#if this.url}}{{this.url}}[{{this.title}}]{{else}}xref:{{this.key}}[{{this.title}}]{{/if}}{{#if this.linkDescription}} - {{this.linkDescription}}{{/if}}
 {{/each}}
 |===
 {empty} +

package/src/exportPdfReport/query.lp.hbs

@@ -131,6 +131,7 @@ select(1, "cardType").
 select(1, "cardTypeDisplayName").
 select(1, "key").
 select(1, "lastUpdated").
+select(1, "createdAt").
 select(1, "links").
 select(1, "notifications").
 select(1, "policyChecks").

package/src/index.ts

@@ -8,6 +8,7 @@ import commonUtils from './calculations/common/utils.lp';
 import queriesCard from './calculations/queries/card.lp';
 import queriesOnCreation from './calculations/queries/onCreation.lp';
 import queriesOnTransition from './calculations/queries/onTransition.lp';
+import queriesConnectors from './calculations/queries/connectors.lp';
 import queriesTree from './calculations/queries/tree.lp';
 import testModel from './calculations/test/model.lp';
 
@@ -34,6 +35,7 @@ export const lpFiles = {
   },
   queries: {
     card: queriesCard,
+    connectors: queriesConnectors,
     onCreation: queriesOnCreation,
     onTransition: queriesOnTransition,
     tree: queriesTree,

package/src/schema/cardBaseSchema.json

@@ -32,6 +32,11 @@
       "format": "date-time",
       "description": "The date and time of the last update of the card"
     },
+    "createdAt": {
+      "type": "string",
+      "format": "date-time",
+      "description": "The date and time when the card was created"
+    },
     "labels": {
       "type": "array",
       "description": "Labels or tags that can be used for organising cards",
@@ -65,6 +70,40 @@
         "additionalProperties": false
       }
     },
+    "externalLinks": {
+      "type": "array",
+      "description": "links from this card to external items in connected systems",
+      "items": {
+        "type": "object",
+        "properties": {
+          "connector": {
+            "type": "string",
+            "minLength": 1,
+            "description": "The name of the connector (e.g., 'jira')"
+          },
+          "externalItemKey": {
+            "type": "string",
+            "minLength": 1,
+            "description": "The key of the external item (e.g., 'PROJECT-1032')"
+          },
+          "linkType": {
+            "description": "The name of the link type. For example, 'base/linkTypes/causes'",
+            "type": "string"
+          },
+          "linkDescription": {
+            "type": "string",
+            "description": "A description of the link"
+          },
+          "direction": {
+            "type": "string",
+            "enum": ["outbound", "inbound"],
+            "description": "Direction of the link: outbound = card links to external, inbound = external links to card"
+          }
+        },
+        "required": ["connector", "externalItemKey", "linkType", "direction"],
+        "additionalProperties": false
+      }
+    },
     "templateCardKey": {
       "type": "string",
       "description": "Card key from which this card has been instantiated"

package/src/schema/cardsConfigSchema.json

@@ -40,6 +40,11 @@
         }
       }
     },
+    "version": {
+      "type": "string",
+      "description": "Project version (semver)",
+      "pattern": "^(0|[1-9]\\d*)\\.(0|[1-9]\\d*)\\.(0|[1-9]\\d*)$"
+    },
     "modules": {
       "description": "List of modules that have been included in the project",
       "type": "array",

package/src/schema/resources/calculationSchema.json

@@ -20,6 +20,10 @@
     "calculation": {
       "description": "The logic programming content for this calculation",
       "type": "string"
+    },
+    "category": {
+      "description": "The category of the calculation. For example, 'ReportData'.",
+      "type": "string"
     }
   },
   "required": ["name"],

package/src/schema/resources/cardTypeSchema.json

@@ -3,6 +3,10 @@
   "additionalProperties": false,
   "description": "Card type defines the workflow and optional additional fields for the cards.",
   "properties": {
+    "category": {
+      "description": "The category of the card type. For example, 'Documentation'.",
+      "type": "string"
+    },
     "name": {
       "description": "The name of the card type",
       "type": "string",

package/src/schema/resources/fieldTypeSchema.json

@@ -1,8 +1,12 @@
 {
   "$id": "fieldTypeSchema",
   "additionalProperties": false,
-  "description": "Field type defines the workflow and optional additional fields for the cards.",
+  "description": "Field type defines one field for a card type",
   "properties": {
+    "category": {
+      "description": "The category of the field type. For example, 'UserData'.",
+      "type": "string"
+    },
     "name": {
       "type": "string",
       "description": "The technical name by which the field is referred to in JSON files.",

package/src/schema/resources/linkTypeSchema.json

@@ -3,6 +3,10 @@
   "additionalProperties": false,
   "description": "Link types defined different ways to link cards together.",
   "properties": {
+    "category": {
+      "description": "The category of the link type. For example, 'Connection'.",
+      "type": "string"
+    },
     "description": {
       "description": "A description that describes the link type",
       "type": "string"
@@ -39,6 +43,13 @@
         "type": "string"
       }
     },
+    "destinationConnectors": {
+      "type": "array",
+      "description": "The connectors that can be the target of this link type for external links.",
+      "items": {
+        "type": "string"
+      }
+    },
     "enableLinkDescription": {
       "type": "boolean",
       "description": "If true, the user can add a description to the link."

package/src/schema/resources/reportSchema.json

@@ -18,11 +18,11 @@
       "type": "string"
     },
     "category": {
-      "description": "The category of the report. For example, 'Architecture'.",
+      "description": "The category of the report. For example, 'KeyPerformanceIndicator'.",
       "type": "string"
     }
   },
-  "required": ["name", "displayName", "category"],
+  "required": ["name", "displayName"],
   "title": "Report",
   "type": "object"
 }

package/src/schema/resources/workflowSchema.json

@@ -3,6 +3,10 @@
   "additionalProperties": false,
   "description": "A state machine for the workflow of cards",
   "properties": {
+    "category": {
+      "description": "The category of the workflow. For example, 'Review'.",
+      "type": "string"
+    },
     "description": {
       "description": "A description that describes the workflow",
       "type": "string"

package/src/schema/version.json

@@ -1,3 +1,3 @@
 {
-  "schemaVersion": 2
+  "schemaVersion": 3
 }

package/src/static/pdf-themes/cyberismo-theme.yml

@@ -49,6 +49,15 @@ header:
     left:
       content: image:img/cyberismo-logo.png[pdfwidth=12%]
 
+ulist:
+  marker:
+    checked:
+      content: "\uf14a"
+      font-family: far
+    unchecked:
+      content: "\uf0c8"
+      font-family: far
+
 footer:
   columns: =100%
   recto: &shared_footer