@futdevpro/nts-dynamo 1.15.151 → 1.15.154

package/.cursor/rules/error_code_pattern.md

@@ -1,40 +1,40 @@
-# Error Code Pattern [FDP-Dev-Error]
-
-## Format
-```
-[PROJ]-[SERV]-[FUNC]
-```
-
-## Components
-- PROJ: 3 character project code
-  - FMP: FDP Master Prompter
-  - CUR: Cursor
-  - DYN: Dynamo
-  - etc.
-- SERV: 3-4 character service code (abbreviated from service name)
-  - DTS: _DataService
-  - CTR: _Controller
-  - SSS: _SocketServerService
-  - SCS: _SocketClientService
-  - EMS: _EmailService
-  - etc.
-- FUNC: 3-4 character function code (derived from function name + index)
-  - NC2: newChange (second throw)
-  - GF1: getFile (first throw)
-  - etc.
-
-## Examples
-- FMP-DTS-NC2: Second error in newChange function of TokenHistory_DataService
-- FMP-CTR-GF1: First error in getFile function of User_Controller
-- CUR-SSS-UP3: Third error in updateProfile function of Chat_SocketServerService
-- DYN-SCS-EM1: First error in sendMessage function of Chat_SocketClientService
-- FMP-EMS-NT1: First error in sendNotification function of Notification_EmailService
-- ASD-SSS-ST0: The function's main try and catch rewrap error point.
-
-## Usage
-- Use in all backend error responses
-- Include in error logs
-- Reference in documentation
-- Keep error codes consistent
-- Document all error codes 
+# Error Code Pattern [FDP-Dev-Error]
+
+## Format
+```
+[PROJ]-[SERV]-[FUNC]
+```
+
+## Components
+- PROJ: 3 character project code
+  - FMP: FDP Master Prompter
+  - CUR: Cursor
+  - DYN: Dynamo
+  - etc.
+- SERV: 3-4 character service code (abbreviated from service name)
+  - DTS: _DataService
+  - CTR: _Controller
+  - SSS: _SocketServerService
+  - SCS: _SocketClientService
+  - EMS: _EmailService
+  - etc.
+- FUNC: 3-4 character function code (derived from function name + index)
+  - NC2: newChange (second throw)
+  - GF1: getFile (first throw)
+  - etc.
+
+## Examples
+- FMP-DTS-NC2: Second error in newChange function of TokenHistory_DataService
+- FMP-CTR-GF1: First error in getFile function of User_Controller
+- CUR-SSS-UP3: Third error in updateProfile function of Chat_SocketServerService
+- DYN-SCS-EM1: First error in sendMessage function of Chat_SocketClientService
+- FMP-EMS-NT1: First error in sendNotification function of Notification_EmailService
+- ASD-SSS-ST0: The function's main try and catch rewrap error point.
+
+## Usage
+- Use in all backend error responses
+- Include in error logs
+- Reference in documentation
+- Keep error codes consistent
+- Document all error codes 
 - All error codes should be unique in the entire system across all projects.

package/.cursor/rules/saved rule mcp server use.md

@@ -1,16 +1,16 @@
-
-Always use the CCAP MCP Server search tools (grep_search, codebase_search) for any code or text search, whenever they are available.
-Only use other search tools if the CCAP MCP Server is unavailable or returns an error.
-If a search is performed with a non-CCAP tool, always explain the reason (e.g., CCAP was not available or failed).
-When both local and CCAP search tools are available, always choose the CCAP MCP Server version.
-If the user asks for a search, always default to the CCAP MCP Server, unless explicitly instructed otherwise.
-If the CCAP MCP Server is temporarily unavailable, notify the user and fall back to the local search tool, but try the CCAP MCP Server again as soon as possible.
-Document in your responses which tool was used for the search, and confirm if it was the CCAP MCP Server.
-If the user wants to change this behavior, only do so if they explicitly request it.
-If you are unsure which tool to use, always ask the user, but default to CCAP MCP Server.
-Always follow all other workspace and user rules in addition to these preferences.
-In addition to the above, before and during any code writing, modification, or implementation, you must always:
-Use the CCAP MCP Server's dedicated tools (related_code_search, related_coding_policy_search) to search for related code examples, existing implementations, and relevant coding policies or guidelines in the workspace and documentation.
-Apply any relevant patterns, examples, or policies found via these tools to ensure consistency and best practices in all new code.
-If no clear example or policy is found, use the closest relevant pattern and document this choice in the development process (e.g., in commit messages or PR descriptions).
+
+Always use the CCAP MCP Server search tools (grep_search, codebase_search) for any code or text search, whenever they are available.
+Only use other search tools if the CCAP MCP Server is unavailable or returns an error.
+If a search is performed with a non-CCAP tool, always explain the reason (e.g., CCAP was not available or failed).
+When both local and CCAP search tools are available, always choose the CCAP MCP Server version.
+If the user asks for a search, always default to the CCAP MCP Server, unless explicitly instructed otherwise.
+If the CCAP MCP Server is temporarily unavailable, notify the user and fall back to the local search tool, but try the CCAP MCP Server again as soon as possible.
+Document in your responses which tool was used for the search, and confirm if it was the CCAP MCP Server.
+If the user wants to change this behavior, only do so if they explicitly request it.
+If you are unsure which tool to use, always ask the user, but default to CCAP MCP Server.
+Always follow all other workspace and user rules in addition to these preferences.
+In addition to the above, before and during any code writing, modification, or implementation, you must always:
+Use the CCAP MCP Server's dedicated tools (related_code_search, related_coding_policy_search) to search for related code examples, existing implementations, and relevant coding policies or guidelines in the workspace and documentation.
+Apply any relevant patterns, examples, or policies found via these tools to ensure consistency and best practices in all new code.
+If no clear example or policy is found, use the closest relevant pattern and document this choice in the development process (e.g., in commit messages or PR descriptions).
 If the CCAP MCP Server or these tools are unavailable, follow the fallback and documentation rules above, and notify the user.

package/.dynamo/pipeline.cicd.config.json

@@ -1,190 +1,190 @@
-{
-  "name": "Dynamo-NTS CI/CD Pipeline",
-  "outputDir": "./logs/cicd-pipeline",
-  "timing": {
-    "stepTimeout": "10m",
-    "teeMaxRuntime": "10m",
-    "stepCooldown": "1s"
-  },
-  "log": {
-    "runtimeMaxBytes": 5242880,
-    "trimCheckEveryN": 1000
-  },
-  "versionBump": {
-    "enabled": false
-  },
-  "report": {
-    "fileName": "cicd-report.json",
-    "includeLogTail": true,
-    "logTailLines": 10000,
-    "includeStepLogs": false
-  },
-  "steps": [
-    {
-      "_comment": "FR-171 (2026-06-13) — auto-introspect ALL steps' condition.envSet + command ${VAR} refs. Reports PRESENT/MISSING env-vars + which downstream steps will silent-skip. Warning-only by default; fail-fast on the `requireSet` list. Goal: never again silent-skip discord/hot-update without surfacing the missing env at step #1.",
-      "label": "validate-secrets",
-      "type": "validate-secrets",
-      "fatal": false,
-      "discord": {
-        "emoji": "🔐",
-        "name": "Secrets Check",
-        "group": "preflight",
-        "groupName": "Pre-flight Check",
-        "groupEmoji": "🔐"
-      },
-      "settings": {
-        "requireSet": [
-          "NPM_TOKEN"
-        ]
-      }
-    },
-    {
-      "label": "discord-start",
-      "command": "dc ci-dn-s '{\"appName\":\"Dynamo-NTS\",\"appEmoji\":\"💽\",\"commitMessage\":\"$COMMIT_MESSAGE\",\"branchName\":\"$GITHUB_REF_NAME\",\"author\":\"$GITHUB_ACTOR\",\"runNumber\":\"$GITHUB_RUN_NUMBER\",\"runId\":\"$GITHUB_RUN_ID\",\"repository\":\"$GITHUB_REPOSITORY\",\"eventName\":\"$GITHUB_EVENT_NAME\",\"eventDateTime\":\"$EVENT_DATETIME\"}'",
-      "fatal": false,
-      "discord": {
-        "hide": true
-      },
-      "condition": {
-        "envSet": [
-          "DISCORD_WEBHOOK_ID"
-        ]
-      }
-    },
-    {
-      "label": "pre-flight",
-      "type": "pre-flight-check",
-      "fatal": true,
-      "discord": {
-        "emoji": "🔐",
-        "name": "Pre-flight Check",
-        "group": "preflight",
-        "groupName": "Pre-flight Check",
-        "groupEmoji": "🔐"
-      },
-      "settings": {
-        "requiredEnvVars": [
-          "NPM_TOKEN"
-        ]
-      }
-    },
-    {
-      "label": "install",
-      "command": "pnpm i",
-      "fatal": true,
-      "discord": {
-        "hide": true
-      }
-    },
-    {
-      "label": "check-dev-leftovers",
-      "type": "check-dev-leftovers",
-      "fatal": false,
-      "discord": {
-        "emoji": "🔍",
-        "name": "Dev Leftovers Check",
-        "group": "preflight"
-      },
-      "settings": {
-        "checks": [
-          {
-            "type": "TSCONFIG_PATHS",
-            "directory": "."
-          },
-          {
-            "type": "PACKAGE_VERSIONS",
-            "directory": ".",
-            "packages": [
-              "@futdevpro/fsm-dynamo"
-            ]
-          }
-        ],
-        "fix": true,
-        "patchOnly": true
-      }
-    },
-    {
-      "label": "build",
-      "command": "npx rimraf ./build && npx tsc",
-      "fatal": true,
-      "discord": {
-        "emoji": "🏗️",
-        "name": "Build",
-        "group": "build-test",
-        "groupName": "Build and Test",
-        "groupEmoji": "🏗️"
-      }
-    },
-    {
-      "label": "test",
-      "command": "npx jasmine",
-      "fatal": true,
-      "discord": {
-        "emoji": "🧪",
-        "name": "Tests",
-        "group": "build-test"
-      },
-      "errorExcludePatterns": [
-        "Error handleMessage: Error: Test error",
-        "getDataByDependencyId failed, dependencyKey is missing",
-        "Error: boom",
-        "Error: diag boom"
-      ]
-    },
-    {
-      "label": "npm-publish",
-      "type": "npm-publish",
-      "fatal": false,
-      "discord": {
-        "emoji": "📦",
-        "name": "NPM Publish"
-      },
-      "condition": {
-        "branchMatch": [
-          "master"
-        ],
-        "allPassed": [
-          "build",
-          "test"
-        ]
-      },
-      "settings": {
-        "directory": ".",
-        "skipIfPublished": true,
-        "retryAttempts": 3,
-        "retryDelaySeconds": 30
-      }
-    },
-    {
-      "label": "pipeline-report",
-      "command": "fdp pipeline-report --report ./logs/cicd-pipeline/cicd-report.json --overseer-secret $OVERSEER_SECRET_KEY --branch $GITHUB_REF_NAME",
-      "fatal": false,
-      "always": true,
-      "discord": {
-        "emoji": "📊",
-        "name": "Build Report"
-      },
-      "condition": {
-        "envSet": [
-          "OVERSEER_SECRET_KEY"
-        ]
-      }
-    },
-    {
-      "label": "discord-result",
-      "command": "fdp pipeline-notify --report ./logs/cicd-pipeline/cicd-report.json --config ./pipeline.cicd.config.json --app-name Dynamo-NTS --app-emoji 💽 --webhook-id $DISCORD_WEBHOOK_ID --webhook-token $DISCORD_WEBHOOK_TOKEN",
-      "fatal": false,
-      "retryOnFail": 2,
-      "retryDelaySec": 5,
-      "always": true,
-      "discord": {
-        "hide": true
-      },
-      "condition": {
-        "envSet": [
-          "DISCORD_WEBHOOK_ID"
-        ]
-      }
-    }
-  ]
-}
+{
+  "name": "Dynamo-NTS CI/CD Pipeline",
+  "outputDir": "./logs/cicd-pipeline",
+  "timing": {
+    "stepTimeout": "10m",
+    "teeMaxRuntime": "10m",
+    "stepCooldown": "1s"
+  },
+  "log": {
+    "runtimeMaxBytes": 5242880,
+    "trimCheckEveryN": 1000
+  },
+  "versionBump": {
+    "enabled": false
+  },
+  "report": {
+    "fileName": "cicd-report.json",
+    "includeLogTail": true,
+    "logTailLines": 10000,
+    "includeStepLogs": false
+  },
+  "steps": [
+    {
+      "_comment": "FR-171 (2026-06-13) — auto-introspect ALL steps' condition.envSet + command ${VAR} refs. Reports PRESENT/MISSING env-vars + which downstream steps will silent-skip. Warning-only by default; fail-fast on the `requireSet` list. Goal: never again silent-skip discord/hot-update without surfacing the missing env at step #1.",
+      "label": "validate-secrets",
+      "type": "validate-secrets",
+      "fatal": false,
+      "discord": {
+        "emoji": "🔐",
+        "name": "Secrets Check",
+        "group": "preflight",
+        "groupName": "Pre-flight Check",
+        "groupEmoji": "🔐"
+      },
+      "settings": {
+        "requireSet": [
+          "NPM_TOKEN"
+        ]
+      }
+    },
+    {
+      "label": "discord-start",
+      "command": "dc ci-dn-s '{\"appName\":\"Dynamo-NTS\",\"appEmoji\":\"💽\",\"commitMessage\":\"$COMMIT_MESSAGE\",\"branchName\":\"$GITHUB_REF_NAME\",\"author\":\"$GITHUB_ACTOR\",\"runNumber\":\"$GITHUB_RUN_NUMBER\",\"runId\":\"$GITHUB_RUN_ID\",\"repository\":\"$GITHUB_REPOSITORY\",\"eventName\":\"$GITHUB_EVENT_NAME\",\"eventDateTime\":\"$EVENT_DATETIME\"}'",
+      "fatal": false,
+      "discord": {
+        "hide": true
+      },
+      "condition": {
+        "envSet": [
+          "DISCORD_WEBHOOK_ID"
+        ]
+      }
+    },
+    {
+      "label": "pre-flight",
+      "type": "pre-flight-check",
+      "fatal": true,
+      "discord": {
+        "emoji": "🔐",
+        "name": "Pre-flight Check",
+        "group": "preflight",
+        "groupName": "Pre-flight Check",
+        "groupEmoji": "🔐"
+      },
+      "settings": {
+        "requiredEnvVars": [
+          "NPM_TOKEN"
+        ]
+      }
+    },
+    {
+      "label": "install",
+      "command": "pnpm i",
+      "fatal": true,
+      "discord": {
+        "hide": true
+      }
+    },
+    {
+      "label": "check-dev-leftovers",
+      "type": "check-dev-leftovers",
+      "fatal": false,
+      "discord": {
+        "emoji": "🔍",
+        "name": "Dev Leftovers Check",
+        "group": "preflight"
+      },
+      "settings": {
+        "checks": [
+          {
+            "type": "TSCONFIG_PATHS",
+            "directory": "."
+          },
+          {
+            "type": "PACKAGE_VERSIONS",
+            "directory": ".",
+            "packages": [
+              "@futdevpro/fsm-dynamo"
+            ]
+          }
+        ],
+        "fix": true,
+        "patchOnly": true
+      }
+    },
+    {
+      "label": "build",
+      "command": "npx rimraf ./build && npx tsc",
+      "fatal": true,
+      "discord": {
+        "emoji": "🏗️",
+        "name": "Build",
+        "group": "build-test",
+        "groupName": "Build and Test",
+        "groupEmoji": "🏗️"
+      }
+    },
+    {
+      "label": "test",
+      "command": "npx jasmine",
+      "fatal": true,
+      "discord": {
+        "emoji": "🧪",
+        "name": "Tests",
+        "group": "build-test"
+      },
+      "errorExcludePatterns": [
+        "Error handleMessage: Error: Test error",
+        "getDataByDependencyId failed, dependencyKey is missing",
+        "Error: boom",
+        "Error: diag boom"
+      ]
+    },
+    {
+      "label": "npm-publish",
+      "type": "npm-publish",
+      "fatal": false,
+      "discord": {
+        "emoji": "📦",
+        "name": "NPM Publish"
+      },
+      "condition": {
+        "branchMatch": [
+          "master"
+        ],
+        "allPassed": [
+          "build",
+          "test"
+        ]
+      },
+      "settings": {
+        "directory": ".",
+        "skipIfPublished": true,
+        "retryAttempts": 3,
+        "retryDelaySeconds": 30
+      }
+    },
+    {
+      "label": "pipeline-report",
+      "command": "fdp pipeline-report --report ./logs/cicd-pipeline/cicd-report.json --overseer-secret $OVERSEER_SECRET_KEY --branch $GITHUB_REF_NAME",
+      "fatal": false,
+      "always": true,
+      "discord": {
+        "emoji": "📊",
+        "name": "Build Report"
+      },
+      "condition": {
+        "envSet": [
+          "OVERSEER_SECRET_KEY"
+        ]
+      }
+    },
+    {
+      "label": "discord-result",
+      "command": "fdp pipeline-notify --report ./logs/cicd-pipeline/cicd-report.json --config ./pipeline.cicd.config.json --app-name Dynamo-NTS --app-emoji 💽 --webhook-id $DISCORD_WEBHOOK_ID --webhook-token $DISCORD_WEBHOOK_TOKEN",
+      "fatal": false,
+      "retryOnFail": 2,
+      "retryDelaySec": 5,
+      "always": true,
+      "discord": {
+        "hide": true
+      },
+      "condition": {
+        "envSet": [
+          "DISCORD_WEBHOOK_ID"
+        ]
+      }
+    }
+  ]
+}

package/.dynamo/version-bump.config.json

@@ -1,5 +1,5 @@
-{
-  "subprojects": [],
-  "generatedConstantFiles": [],
-  "gitAdd": true
-}
+{
+  "subprojects": [],
+  "generatedConstantFiles": [],
+  "gitAdd": true
+}