@cyberismo/assets 0.0.22 → 0.0.24

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;
@@ -183,7 +222,7 @@ export declare const schemas: ({
                 properties: {
                     name: {
                         description: string;
-                        type: string;
+                        $ref: string;
                     };
                     displayName: {
                         description: string;
@@ -201,10 +240,6 @@ export declare const schemas: ({
                         description: string;
                         type: string;
                     };
-                    branch: {
-                        description: string;
-                        type: string;
-                    };
                     private: {
                         description: string;
                         type: string;
@@ -217,6 +252,18 @@ export declare const schemas: ({
     required: string[];
     title: string;
     type: string;
+} | {
+    $id: string;
+    $schema: string;
+    additionalProperties: boolean;
+    properties: {
+        code: {
+            type: string;
+            description: string;
+        };
+    };
+    required: string[];
+    type: string;
 } | {
     $id: string;
     additionalProperties: boolean;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@cyberismo/assets",
-  "version": "0.0.22",
+  "version": "0.0.24",
   "description": "This package contains static resources",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",
@@ -15,7 +15,7 @@
   "bugs": "https://github.com/CyberismoCom/cyberismo/issues",
   "type": "module",
   "devDependencies": {
-    "esbuild": "^0.27.2",
+    "esbuild": "^0.28.0",
     "esbuild-plugin-import-glob": "^0.1.1"
   },
   "files": [

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

@@ -4,13 +4,13 @@
 :toc: macro
 :numbered:
 :imagesdir: images
-:revnumber: {{version}}
-:revdate: {{date}}
-:revremark: {{revremark}}
-:!chapter-signifier:
+{{#if version}}:revnumber: {{version}}
+{{/if}}{{#if date}}:revdate: {{date}}
+{{/if}}{{#if revremark}}:revremark: {{revremark}}
+{{/if}}:!chapter-signifier:
 :source-highlighter: rouge
 :toclevels: 5
-+
+
 toc::[]
 {{#each results}}
   {{#include}}
@@ -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,13 +8,16 @@ 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';
 
-import pdfReportIndex from './exportPdfReport/index.adoc.hbs';
-import pdfReportQuery from './exportPdfReport/query.lp.hbs';
-import graphvizReportIndex from './graphvizReport/index.adoc.hbs';
-import graphvizReportQuery from './graphvizReport/query.lp.hbs';
+import pdfReportIndex from './exportPdfReport/index.adoc.hbs' with { type: 'text' };
+import pdfReportQuery from './exportPdfReport/query.lp.hbs' with { type: 'text' };
+import graphvizReportIndex from './graphvizReport/index.adoc.hbs' with { type: 'text' };
+import graphvizReportQuery from './graphvizReport/query.lp.hbs' with { type: 'text' };
+import workflowGraphModel from './workflowGraph/model.lp' with { type: 'text' };
+import workflowGraphView from './workflowGraph/view.lp.hbs' with { type: 'text' };
 
 export const graphvizReport = {
   query: graphvizReportQuery,
@@ -26,6 +29,11 @@ export const pdfReport = {
   content: pdfReportIndex,
 };
 
+export const workflowGraph = {
+  model: workflowGraphModel,
+  view: workflowGraphView,
+};
+
 export const lpFiles = {
   common: {
     base: commonBase,
@@ -34,6 +42,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

@@ -1,4 +1,13 @@
 {
+  "$defs": {
+    "projectPrefix": {
+      "type": "string",
+      "description": "Project prefix: 3–10 lowercase letters.",
+      "pattern": "^[a-z]+$",
+      "minLength": 3,
+      "maxLength": 10
+    }
+  },
   "$id": "cardsConfigSchema",
   "additionalProperties": false,
   "description": "General configuration settings for the card tree.",
@@ -8,11 +17,8 @@
       "description": "Project schema version"
     },
     "cardKeyPrefix": {
-      "type": "string",
       "description": "The prefix or the fist component of the card key. For example, ABC",
-      "pattern": "^[a-z]+$",
-      "minLength": 3,
-      "maxLength": 10
+      "$ref": "#/$defs/projectPrefix"
     },
     "name": {
       "description": "Project name",
@@ -40,6 +46,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",
@@ -48,19 +59,19 @@
         "properties": {
           "name": {
             "description": "Module name (project prefix). Must be unique.",
-            "type": "string"
+            "$ref": "#/$defs/projectPrefix"
           },
           "location": {
             "description": "Git remote URL, or relative file reference.",
             "type": "string"
           },
-          "branch": {
-            "description": "If using git remote URL in 'location' defines git branch. If empty, uses repository default branch'.",
-            "type": "string"
-          },
           "private": {
             "description": "If true, the module is private and requires credentials (CYBERISMO_GIT_USER / CYBERISMO_GIT_TOKEN) or SSH. Does not apply for local file modules.",
             "type": "boolean"
+          },
+          "version": {
+            "description": "Semver version or range constraint (e.g., '1.0.0', '^1.0.0', '>=1.2.0 <2.0.0'). When omitted, any version is accepted.",
+            "type": "string"
           }
         },
         "required": ["name", "location"]

package/src/schema/hubSchema.json

@@ -26,7 +26,7 @@
         "properties": {
           "name": {
             "description": "Module name (project prefix). Must be unique globally.",
-            "type": "string"
+            "$ref": "cardsConfigSchema#/$defs/projectPrefix"
           },
           "displayName": {
             "description": "Display name of the module",
@@ -44,10 +44,6 @@
             "description": "URI to the documentation of the module",
             "type": "string"
           },
-          "branch": {
-            "description": "If using git remote URL in 'location' defines git branch. If empty, uses repository default branch'.",
-            "type": "string"
-          },
           "private": {
             "description": "If true, the module is private and requires credentials (CYBERISMO_GIT_USER / CYBERISMO_GIT_TOKEN) or SSH. Does not apply for local file modules.",
             "type": "boolean"

package/src/schema/macros/mermaidMacroSchema.json

@@ -0,0 +1,13 @@
+{
+  "$id": "mermaidMacroSchema",
+  "$schema": "http://json-schema.org/draft-07/schema#",
+  "additionalProperties": false,
+  "properties": {
+    "code": {
+      "type": "string",
+      "description": "Mermaid diagram definition text"
+    }
+  },
+  "required": ["code"],
+  "type": "object"
+}

package/src/schema/resources/linkTypeSchema.json

@@ -43,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/version.json

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

package/src/schemas.ts

@@ -27,6 +27,7 @@ import hubSchema from './schema/hubSchema.json' with { type: 'json' };
 import imageMacroSchema from './schema/macros/imageMacroSchema.json' with { type: 'json' };
 import includeMacroSchema from './schema/macros/includeMacroSchema.json' with { type: 'json' };
 import linkTypeSchema from './schema/resources/linkTypeSchema.json' with { type: 'json' };
+import mermaidMacroSchema from './schema/macros/mermaidMacroSchema.json' with { type: 'json' };
 import percentageMacroSchema from './schema/macros/percentageMacroSchema.json' with { type: 'json' };
 import reportMacroBaseSchema from './schema/macros/reportMacroBaseSchema.json' with { type: 'json' };
 import reportSchema from './schema/resources/reportSchema.json' with { type: 'json' };
@@ -58,6 +59,7 @@ export const schemas = [
   imageMacroSchema,
   includeMacroSchema,
   linkTypeSchema,
+  mermaidMacroSchema,
   percentageMacroSchema,
   reportMacroBaseSchema,
   reportSchema,

package/src/workflowGraph/model.lp

@@ -0,0 +1,86 @@
+graph(toplevelGraph).
+attr(graph, toplevelGraph, rankdir, "TD").
+
+% the "initial node" from where the card is created
+node("", toplevelGraph) :- workflowState(Workflow, State, _), visible(Workflow).
+
+% Let's add a separate "Any state" for every state that has transitions from "*"
+node(("*", To), toplevelGraph) :-
+    workflowTransition(Workflow, _, "*", To),
+    visible(Workflow).
+
+attr(node, ("*", To), label, @concatenate("<<font point-size='11'> Any state </font>>")) :-
+    workflowTransition(Workflow, _, "*", To),
+    visible(Workflow).
+
+node(State, toplevelGraph) :- workflowState(Workflow, State, _), visible(Workflow).
+
+% Regular state label
+attr(node, State, label, @concatenate("<<font point-size='14'> <b>", State, "</b> </font> <br/> <font point-size='10'>", StateCategory, "</font>>")) :-
+    workflowState(Workflow, State, StateCategory),
+    visible(Workflow),
+    not currentState(State),
+    State != "",
+    State != "*".
+
+% Current state label is rendered larger and underlined to stand out
+attr(node, State, label, @concatenate("<<font point-size='16'> <b><u>", State, "</u></b> </font> <br/> <font point-size='10'>", StateCategory, "</font>>")) :-
+    workflowState(Workflow, State, StateCategory),
+    visible(Workflow),
+    currentState(State),
+    State != "",
+    State != "*".
+
+edge((From, To, Transition), toplevelGraph) :-
+    workflowTransition(Workflow, Transition, From, To),
+    visible(Workflow),
+    From != "*".
+
+attr(edge, (From, To, Transition), label, @concatenate("<<font point-size='10'>", Transition, "</font>>")) :-
+    workflowTransition(Workflow, Transition, From, To),
+    visible(Workflow),
+    From != "*".
+
+edge((("*", To), To, Transition), toplevelGraph) :-
+    workflowTransition(Workflow, Transition, "*", To),
+    visible(Workflow).
+
+attr(edge, (("*", To), To, Transition), label, @concatenate("<<font point-size='10'>", Transition, "</font>>")) :-
+    workflowTransition(Workflow, Transition, "*", To),
+    visible(Workflow).
+
+% margins
+attr(graph, toplevelGraph, pad, "0.1").
+attr(graph, toplevelGraph, nodesep, "0.6").
+attr(graph, toplevelGraph, ranksep, "0.7").
+attr(node, X, margin, "0.15") :- node(X, _).
+attr(graph, X, margin, "8") :- graph(X, _).
+
+% penwidth
+attr(graph, X, penwidth, "1") :- graph(X).
+attr(graph, X, penwidth, "1") :- graph(X, _).
+attr(node, X, penwidth, "1") :- node(X, _), X != "", not currentState(X).
+attr(node, X, penwidth, "3") :- node(X, _), currentState(X).
+attr(node, X, penwidth, "2") :- node(X, _), X = "".
+attr(edge, (X, Y, N), penwidth, "1") :- edge((X, Y, N), _).
+attr(edge, (X, Y, N), arrowsize, "0.8") :- edge((X, Y, N), _).
+
+% shapes of nodes
+attr(node, X, shape, rectangle) :- node(X, _), X != "".
+attr(node, X, shape, circle) :- node(X, _), X = "".
+attr(node, X, style, rounded) :- node(X, _).
+
+% node colours
+attr(node, State, color, "#FF9300") :-
+    workflowState(Workflow, State, "active"),
+    visible(Workflow).
+
+attr(node, State, color, "#37E900") :-
+    workflowState(Workflow, State, "closed"),
+    visible(Workflow).
+
+% fonts
+attr(graph, G, fontname, "helvetica") :- graph(G).
+attr(graph, G, fontname, "helvetica") :- graph(G, _).
+attr(node, N, fontname, "helvetica") :- node(N, _).
+attr(edge, (X, Y, N), fontname, "helvetica") :- edge((X, Y, N), _).

package/src/workflowGraph/view.lp.hbs

@@ -0,0 +1,4 @@
+visible("{{{clingoEscape workflow}}}").
+{{#if currentState}}
+currentState("{{{clingoEscape currentState}}}").
+{{/if}}